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Release and Update Information 


SECTION 1 
INTRODUCTION 

This document contains a summary of Distribution 3 contents, 
procedures to update systems running Distribution 2 software 
to Distribution 3, and procedures to do a complete re- 

installation of Distribution 3 on a disk which has become 

totally corrupted. 

New Rack and Office Systems are shipped with Distribution 3 
already installed; no software installation is required. 

The following manuals should be read before proceeding with 
and update or installation procedures: 

Nu Machine Installation and User Manual 

Nu Machine Operating System User Guide 

In addition, the following manuals can be an aid to under¬ 
standing the procedures and commands used in this manual. 

Nu Machine SDU Monitor User's Manual 

Nu Machine UNIX"' Programmer's Manual 

WARNING: UPDATING TO DISTRIBUTION 3 SOFTWARE INVOLVES COM¬ 
PLETE DESTRUCTION OF DATA ON SOME DISK PARTITIONS. ANY USER 
PILES SHOULD BE SAVED ON TAPE BEFORE STARTING THE SOFTWARE 
INSTALLATION PROCEDURE. 


^UNIX is a trademark of Bell Telephone Laboratories, Incor¬ 
porated. 
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SECTION 1 

DISTRIBUTION 3 SUMMARY 

The following is a summary of the changes included in the 
Distribution 3 package; 


1. Kernel, driver and command bug fixes to increase stabil¬ 

ity of the system. 

2. New commands; ac, cal, comm, til, iostat, Ipr, spell, 

split, tbl, and tip. 

3. An optional change to increase the disk interleave fac¬ 

tor. This change will increase performance on a loaded 
system. 

4. Updates to the Mu Machine diagnostics. 

5. The disk partitioning has been modified to allow a 

separate small file system for the SDU which contains 
GpU commands, diagnostics, and drivers. The new parti¬ 
tion which has been added is /dev/dk0g. The UNIX root 
is still /dev/dk0a» This was accomplished by splitting 
the old UNIX root into 2 pieces. The starting positions 
for other disk partitions has NOT changed. 

6. As a result of the addition of /dev/dk0g, the /monitor 

directory is now in the SDU file system (instead of the 
UNIX root file system) and is referenced by 
/sdu/monitor. 

7. Under the SDU Monitor, /disk will reference /dev/dk0g 

(not the UNIX root). The UNIX root is accessed by using 
a new SDU driver called uroot. The default path name 
used by uboot has been changed to /uroot/unix from the 
old /disk/unix. 

8. New manuals; 

Nu Machine UNIX Programmer's Volume 2B 
Nu Machine Operating System User Guide 

9. No changes to the SDU Monitor. 
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SECTION 2 

DISTRIBUTION TAPE CONTENTS 

The Distribution 3 software is provided on 2 1/2" tapes for 
Rack Systems, or 2 1/4" tapes for Office Systems. The 1/2" 
and 1/4" versions of each tape contain the same files, only 
the media is different. A set of 1/2" tapes can be used with 
and Office system if it has a 1/2" tape drive and vice-versa 
for 1/4" tapes. 

The first tape is the Nu Machine Diagnostic tape. It con¬ 
tains 3 files; 

file 1: 

Tar driver for the SDU Monitor. 

file 2: 

Tar of diagnostics, 
file 3: 

A file system image of the SDU file system which con¬ 
tains diagnostics, SDU commands, and SDU drivers. 

The second tape is the Nu Machine UNIX Distribution tape. It 
contains 2 files; 

file 1; 

UNIX root file system image. 

file 2; 

Tar of /usr. 
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SECTION 3 

UPDATING TO DISTRIBUTION 3 

This section contains procedures for updating systems which 
are currently running Distribution 2 software. If the sys¬ 
tem is not now running Distribution 2 software or if the 
disk has been corrupted, then see Section 4 for full instal¬ 
lation procedures. This procedure is ONLY for update pur¬ 
poses . 

If the new disk interleave factor is desired, then the disk 
must be reformatted. See Section 4 and follow the full 
installation procedures. The change of disk interleave fac¬ 
tor is OPTIONAL. If this new interleave is NOT desired, then 
continue the update procedures and DO NOT RE-FORMAT THE 
DISK. 

The update procedure involves replacement of the UNIX root 
file system (/dev/dk0a), addition of the SDU file system 
(/dev/dk0g), and update of /usr. Be sure to save any user 
added or user modified files which are in the root. Exam¬ 
ples are /etc/passwd, /etc/motd, and /etc/ident. Although 
this procedure is non-destructive to user files on /usr, as 
a safety precaution, it is recommended that ALL user added 
or modified files in all file systems be backed up before 
preceding. 

New Rack and Office Systems are shipped with Distribution 3 
already installed; no software installation is required. 

IMPORTANT: UPDATING TO DISTRIBUTION 3 INVOLVES DATA DESTRUC¬ 
TION ON SOME DISK PARTITIONS. BACKUP YOUR LOCAL FILES VIA 
TAR BEFORE STARTING ANY OF THE INSTALLATION PROCEDURES. 

If the system is to be upgraded to Distribution 3, the 
entire procedure must be followed. Do not mix any part of 
the now software with old software. 
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SECTION 3.1 
RACK SYSTEM UPDATE 

This update procedure applies to systems with Fujitsu Eagle 
disk drives using 1/2" tape drive. 


1. Bring down the currently running UNIX to the 3DU Monitor 

(be sure to sync first). SDU Monitor should respond 
with a >> prompt. 

2. Load the Nu Machine Diagnostic tape. 

3. Setup the CMOS ram. The contents of CMOS RAM have changed 

to reflect the new disk partition. This step MUST be 
performed even if the SETUP light is not on. 

>> init 

>> /tar/setup clear 
>> /tar/setup eagle sp shell 

4. Reset the system and check that the SETUP light goes out 

and the RUN light is on. Do not continue with the 
installation procedure if the RUN light is not on. 

5. Copy the SDU file system image from tape to disk via; 

>> init 

>> copy tape/3 $disk 

The SDU Monitor should respond with "1047552 bytes 
copied". 

6. Load the Wu Machine UNIX Distribution tape. 

7. Copy the UNIX root file system image from tape to disk 

via; 

>> init 

>> cp tape/1 $disk 1023 -6942 

The SDU Monitor should respond with "cp finished; 
7108608 bytes copied". In some cases the message "pro¬ 
cess got multibus timeout" may appear. This message can 
be ignored in this case only. 

8. Boot UNIX via (assumes switch setting 3); 

>> init 

>> uboot -k rsd -C /disk/monitor/conf/std.eagle 

If switch setting 1 is being used, change rsd to ttya 
in the uboot command. As an alternative, or for non- 


Printed 11/3/83 


5 



Release and Update Information 


standard board configurations the auto-configuration 
option can be used with uboot; 

>> init 

>> uboot -a -k rsd 

9. Single-user UNIX should now be running. Several links 

must be added as follows: 

# /etc/mount /dev/dk0g /sdu 

# cd /sdu/monitor/conf 

# In std.eagle std 

# cd /etc 

# In rc.eagle rc 

# In fstab.eagle fstab 

# In checklist.eagle checklist 

# sync 

# /etc/umount /dev/dk0g 

10. Set the date, sync the disk, and go multi-user via: 

# date yynunddhhitun. ss 

# sync 

# "D 

11. Login as root and un-tar /usr via: 

-> cd /usr 

-> tar xpvf /dev/rmt0 

NOTE: If for any reason the tape has been moved since 
the UNIX root was copied from it, or if the tar failed 
an you want to retry it, you will need to reposition 
the tape to file 2 via: 

-> dd if=/dev/rmt0 of=/dev/null count=l 
-> dd if=/dev/rmt4 of=/dev/null bs=lk 
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SECTION 3.2 
OFFICE SYSTEM UPDATE 

This update procedure applies to systems with Fujitsu Micro 
disk drives using 1/4" tape drive. 


1. Bring down the currently running UNIX to the SDU Monitor 

(be sure to sync first). SDU Monitor should respond 
w'ith a > > prompt. 

2. Load the Nu Machine Diagnostic tape. 

3. Setup the CMOS ram. The contents of CMOS RAM have changed 

to reflect the new disk partition. This step MUST be 
performed even if the SETUP light is not on. 

> > init 

>> /tarq/setup clear 
>> /tarq/setup micro sp shell 

4. Reset the system and check that the SETUP light goes out 

and the RUN light is on. Do not continue with the 
installation procedure if the RUN light is not on. 

5. Copy the SDU file system image from tape to disk via: 

>> init 

>> copy quart/3 $disk 

The SDU Monitor should respond with "1047552 bytes 
copied". 

6. Load the Wu Machine UNIX Distribution tape. 

7. Copy the UNIX root file system image from tape to disk 

via; 

>> init 

>> cp quart/1 $disk 1023 -6942 

The SDU Monitor should respond with "cp finished; 
7108608 bytes copied". In some cases the message "pro¬ 
cess got multibus timeout" may appear. This message can 
be ignored in this case only. 

8. Boot UNIX via (assumes switch setting 3); 

> > init 

>> uboot -k rsd -C /disk/monitor/conf/std.micro 

If switch setting 1 is being used, change rsd to ttya 
in the uboot command. As an alternative, or for non- 
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standard board configurations the auto—configuration 
option can be used on uboot: 

>> init 

>> uboot -a -k rsd 


9. Single-user UNIX should now be running. Several links 
must be added as follows; 


# 

# 

# 

# 

# 

# 

# 

# 

# 


/etc/mount /dev/dk0g /sdu 
cd /sdu/monitor/conf 
In std.micro std 
cd /etc 

In rc.micro rc 
In fstab.micro fstab 
In checklist.micro checklist 
sync 

/etc/umount /dev/dk0g 


10. Set the date, sync the disk, and go multi-user via; 

# date yymmddhhmm.ss 

# sync 

# "D 


11. Login as root and un-tar /usr via; 

-> cd /usr 
-> qtrop bot 
-> qtrop rdmark 
-> tar xpvf /dev/rqt0 


Printed 11/3/83 


8 



Release and Update Information 


SECTION 4 

COMPLETE INSTALLATION 

This section contains full installation procedures for Dis¬ 
tribution 3. These procedures are used to restore a system 
disk when it has become totally corrupted, or to change disk 
interleave factor. For update of systems currently running 
Distribution 2, see Section 3. 

New Rack and Office Systems are shipped with Distribution 3 
already Installed; no software Installation is required. 

IMPORTANTI INSTALLING DISTRIBUTION 3 INVOLVES DATA DESTRUC¬ 
TION ON SOME DISK PARTITIONS AND MAY INVOLVE REFORMATTING 
THE DISK. BACKUP YOUR LOCAL FILES VIA TAR BEFORE STARTING 
ANY OF THE INSTALLATION PROCEDURES. 

If the Distribution 3 software is to be installed, the 
entire procedure must be followed. Do not mix any part of 
the new software with old software. 
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SECTION 4.1 

RACK SYSTEM INSTALLATION 

The following procedure is for installation of Distribution 
3 software on Rack systems with Fujitsu Eagle disk drive. 


1. Power up the system, select switch setting 3, and reset. 

The SDU Monitor should respond with a >> prompt on the 
rsd. 

NOTE: If the SETUP light remains on after the reset, 
then the SDU defaults to Mode Switch position 0. In 
this case only, a terminal must be connected to the SDU 
remote serial port (ttya) and be set to 300 baud to do 
step 4. 

If an rsd is not available, a terminal connected to 
ttya can be used by selecting switch setting 1. How¬ 
ever, when SETUP remains on after ,r,e,set, the terminal 
should be set to 300 baud. After s^ti^dp is complete and 
the system is reset, the terminal should be set to 9600 
baud. 

2. Load the Nu Machine Diagnostics tape. 

3. Setup the CMOS ram via: 

> > init 

>> /tar/setup clear 
>> /tar/setup eagle sp shell 

4. Reset the system and check that the SETUP light goes out 

and the RUN light is on. 

Do not continue with the installation procedure if the 
RUN light is not on. The prompt should now appear on 
the rsd if sv/itch setting 3 is used, or on ttya if 
switch setting 1 is used. The terminal on ttya must 
now be set to 9600 baud. 

5. If the state of the disk is unknown or the new interleave 

factor is desired, then the disk must be reformatted. 

£f the disk was already formatted and was running Dis¬ 
tribution 2 software, then this step may be skipped. 
Reformat the disk via: 

>> /tar/2181 -tvDF 

6. Copy the SDU file system image from tape to disk via; 

>> init 

>> copy tape/3 $disk 
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The SDU Monitor should respond with "1047552 bytes 
copied". 

7. Load the Nu machine UNIX Distribution tape. 

8. Copy the UNIX root file system image to disk via; 

>> init 

>> cp tape/1 $disk 1023 -6942 

The SDU Monitor should respond with "cp finished; 
7108608 bytes copied". In some cases the message "pro¬ 
cess got multibus timeout" may appear. This message can 
be ignored in this case only. 

9. Boot UNIX via (assumes sv/itch setting 3); 

>> init 

>> uboot -k rsd -C /disk/monitor/conf/std.eagle 

If switch setting 1 is being used, change rsd to ttya 
in the uboot command. As an alternative, or for non¬ 
standard board configurations the auto-configuration 
option can be used on uboot; 

>> init 

>> uboot -a -k rsd 

10. Single-user UNIX should now be running. Build new file 

systems via; 

# csh makedisk eagle 

CAUTION; makedisk contains commands to make file sys¬ 
tems (mkfs). This results in total loss of any files 
that were on the disk. Makedisk should only be run 
once during the installation procedure. VThen installa¬ 
tion is complete, makedisk should be removed to ensure 
that is is not accidentally run. 

11. Set the date, sync the disk, and go multi-user via; 

# date yymmddhhmm.ss 

# sync 

# “D 

12. Login as root and un-tar /usr via; 

-> cd /usr 

-> tar xpvf /dev/rmt0 

NOTE; If for any reason the tape has been moved since 
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the root was copied from it, or if the tar failed an 
you want to retry it, you will need to reposition the 
tape to file 2 via: 

-> dd if=/dev/rmt0 of=/dev/null count=l 
“> dd if=/dev/rmt4 of=/dev/null bs=lk 
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SECTION 4.2 

OFFICE SYSTEM INSTALLATION 

The following procedure is for installation of Distribution 
3 software on Office systems with Fujitsu Micro disk'drive. 


1. Power up the system, select switch setting 3', and reset. 

The SDU Monitor should respond with a >>, prompt on the 
rsd. 

NOTE: If the SETUP light remains on after the reset, 
then the SDU defaults to Mode Switch position 0. In 
this case only, a terminal must be connected to the SDU 
remote serial port (ttya) and be set to 300 baud to do 
step 4. 

If an rsd is not available, a terminal connected to 
ttya can be used by selecting switch setting 1. How¬ 
ever, when SETUP remains on after reset, the terminal 
should be set to 300 baud. After setup is complete and 
the system is reset, the terminal should be set to 9600 
baud. 

2. Load the Nu Machine Diagnostics tape. 

3. Setup the CMOS ram via: 

>> init 

>> /tarq/setup clear 
>> /tarq/setup micro sp shell 

4. Reset the system and check that the SETUP light goes out 

and the RUN light is on. 

Do not continue with the installation procedure if the 
RUN light is not on. The prompt should now appear on 
the rsd if switch setting 3 is used, or on ttya if 
switch setting 1 is used. The terminal on ttya must 
now be set to 9600 baud. 

5. If the state of the disk is unknown or the new interleave 

factor is desired, then the disk must be reformatted. 

If the disk was already formatted and was running Dis¬ 
tribution 2 software, then this step may be skipped. 
Reformat the disk via: 

>> /tarq/2181 -tvDF 

6. Copy the CDU file system image from tape to disk via: 

>> init 

>> copy quart/3 $disk 
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The SDU Monitor should respond with "1047552 bytes 
copied". 

7. Load the Nu machine UNIX Distribution tape. 

8. Copy the UNIX root file system image to disk via; 

>> init 

>> cp quart/1 $disk 1023 -6942 

The SDU Monitor should respond with "cp finished; 
7108608 bytes copied". In some cases the message "pro¬ 
cess got multibus timeout" may appear. This message can 
be ignored in this case only. 

9. Boot UNIX via (assumes switch setting 3); 

>> init 

>> uboot -k rsd -C /disk/monitor/conf/std.micro 

If switch setting 1 is being used, change rsd to ttya 
in the uboot command. As an alternative, or for non- 
standard board configurations the auto-configuration 
option can be used on uboot; 

>> init 

>> uboot -a -k rsd 

10. Single-user UNIX should now be running. Build new file 

systems via; 

# csh makedisk micro 

CAUTION: makedisk contains commands to make file sys¬ 
tems (mkfs). This results in total loss of any files 
that were on the disk. Makedisk should only be run 
once during the installation procedure. vfhen installa¬ 
tion is complete, makedisk should be removed to ensure 
that is is not accidentally run. 

11. Set the date, sync the disk, and go multi-user via; 


# date yymmddhhmm.ss 

# sync 

# '‘D 

12. Login as root and un-tar /usr via; 


-> cd /usr 
-> qtrop bot 
-> qtrop rdmark 
-> tar xpvf /dev/rqt0 
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SECTION 5 
TROUBLESHOOTING 

If there are problems installing the software system, an 
example of a troubleshooting flow is contained in the Nu 
Machine Operating System User Guide. If further problems 
exist, contact Customer Technical Services, Texas Instru¬ 
ments, Irvine, (714) 660-8217. 
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NAME 

intro - introduction to commands 


DESCRIPTION 

This section describes publicly accessible commands in 
alphabetic order. Certain distinctions of purpose are made 
in the headings: 


(1) Commands 

(1C) Commands 

(IG) Commands 
design. 

(IM) Commands 


of general utility. 

for communication with other systems. 

used primarily for graphics and computer-aided 

used primarily for system maintenance. 


DIAGNOSTICS 

Upon termination each command returns two bytes of status, 
one supplied by the system giving the cause for termination, 
and (in the case of 'normal' termination) one supplied by 
the program, see wait and exit(2). The former byte is 3 for 
normal termination, the latter is customarily 0 for 
successful execution, nonzero to indicate troubles such as 
erroneous parameters, bad or inaccessible data, or other 
inability to cope with the task at hand. It is called 
variously 'exit code', 'exit status' or 'return code', and 
is described only where special conventions are involved. 
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NAME 

aSe - assembler for the Intel iAPX86 
SYNOPSIS 

a86 C option ] file 
DESCRIPTION 

A86 assembles the named file. 

The following options are interpreted by a86. 

-o output 

Name the output file output . If this option is not 
specified, the output file is named file .b86. Where 
file is the name of the input file. 

“1 Create a listing file named file .list, where file is 

the name of the input file. 

-s Create a listing of the symbol table on the list 

file. 

-b Perform span dependent instruction optimization. 

SEE ALSO 

ld86(l), nm86(l), b.out(5) 

DIAGNOSTICS 

^■nien syntactic or semantic errors occur, the line that the 
error occurred on and an error number is printed. Following 
all of the lines in error, a summary of the error numbers 
and the text of the error message is printed. If a listing 
file (-1) option was specified, lines in error are not 
echoed — examine the list file to determine the problems. 
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NAME 

ac - login accounting 
SYNOPSIS 

ac C -w wtmp ] C -p ] C -d ] C people ] ... 

DESCRIPTION 

Ac produces a printout giving connect time for each user who 
has logged in during the life of the current wtmp file. A 
total is also produced, -w is used to specify an alternate 
wtm^ file. -p prints individual totals; without this 
option, only totals are printed. -d causes a printout for 
each midnight to midnight period. Any people will limit the 
printout to only the specified login names. If no wtmp file 
is given, / usr / adm / wtmp is used. 

The accounting file / usr / adm / wtmp is maintained by init and 
login . Neither of these programs creates the file, so if it 
does not exist no connect-time accounting is done. To start 
accounting, it should be created with length 0. On the 
other hand if the file is left undisturbed it will grow 
without bound, so periodically any information desired 
should be collected and the file truncated. 


PILES 

/usr/adm/wtmp 
SEE ALSO 

init(8), login(l), utmp(5). 
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NAME 

adb - debugger 
SYNOPSIS 

adb C-w] C objfil [ corfil ] 3 
DESCRIPTION 

Adb is a general purpose debugging program. It may be used 
to examine files and to provide a controlled environment for 
the execution of UNIX programs. 

Objfi l is normally an executable program file, preferably 
containing a symbol table; if not then the symbolic features 
of adb cannot be used although the file can still be 
examined. The default for objfil is a.out. Corfil is 
assumed to be a core image file produced after executing 
obj fil ; the default for corfil is core. 

Requests to adb are read from the standard input and 
responses are to the standard output. If the -w flag is 
present then both objfil and corfil are created if necessary 
and opened for reading and writing so that files can be 
modified using adb . Adb ignores QUIT; INTERRUPT causes 
return to the next adb command. 

In general requests to adb are of the form 

[ address ] [, count ] [ command ] [;] 

If address is present then dot is set to address . Initially 
dot is set to 0. For most commands count specifies how many 
times the command will be executed. The default count is 1. 
Address and count are expressions. 

The interpretation of an address depends on the context it 
is used in. If a subprocess is being debugged then 
addresses are interpreted in the usual way in the address 
space of the subprocess. For further details of address 
mapping see ADDRESSES. 

EXPRESSIONS 

. The value of dot. 


+ The value of dot incremented by the current 

increment. 

The value of dot decremented by the current 
increment. 

" The last address typed. 


integer 
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An octal number if integer begins with a 0; a 
hexadecimal number if preceded by #; otherwise a 
decimal number. 

integer . fraction 

A 32 bit floating point number. 

* cccc ‘ The ASCII value of up to 4 characters. \ may be used 
to escape a '. 

< name The value of name , which is either a variable name or 
a register name. Adb maintains a number of variables 
(see VARIABLES) named by single letters or digits. 

If name is a register name then the value of the 
register is obtained from the system header in 
corfil . The register names are r0 ... r5 sp pc ps. 

symbol A symbol is a sequence of upper or lower case 

letters, underscores or digits, not starting with a 
digit. The value of the symbol is taken from the 
symbol table in objfil . An initial _ or ~ will be 
prepended to symbol if needed. 

_ symbol 

In C, the 'true name' of an external symbol begins 
with _. It may be necessary to utter this name to 
disinguish it from internal or hidden variables of a 
program. 

routine . name 

The address of the variable name in the specified C 
routine. Both routine and name are symbols . If name 
is omitted the value is the address of the most 
recently activated C stack frame corresponding to 
routine . 

( exp ) The value of the expression exp . 

Monadic operators 

The contents of the location addressed by. exp in 
corfil . 

The contents of the location addressed by exp in 
ob j fil . 

Integer negation. 

Bitwise complement. 

Dyadic operators ace left associative and are less binding 

than monadic operators. 


* exp 

0 exp 

- exp 

~ exp 
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el-»e2 Integer addition. 
el-e2 Integer subtraction. 
el*e2 Integer multiplication. 
el%e2 Integer division. 
el&e2 Bitwise conjunction, 
elle^ Bitwise disjunction. 

el#e2 El rounded up to the next multiple of e2 . 

COMMANDS 

Most commands consist of a verb followed by a modifier or 
list of modifiers. The following verbs are available. (The 
commands '?' and '/' may be followed by see ADDRESSES 

for further details.) 

Locations starting at address in objfil are printed 
according to the format f. 

/f Locations starting at address in corfil are printed 
according to the format f. 

The value of address itself is printed in the styles 
indicated by the format _f. (For i format '?' is 
printed for t}\e parts of the instruction that reference 
subsequent words.) 

A format consists of one or more characters that specify a 
style of printing. Each format character may be preceded by 
a decimal integer that is a repeat count for the format 
character. While stepping through a format dot is 
incremented temporarily by the amount given for each format 
letter. If no format is given then the last format is used. 
The format letters available are as follows. 

o 2 Print 2 bytes in octal. All octal numbers output 
by adb are preceded by 0. 

O 4 Print 4 bytes in octal, 
q 2 Print in signed octal. 

Q 4 Print long signed octal, 
d 2 Print in decimal. 

D 4 Print long decimal. 

X 2 Print 2 bytes in hexadecimal. 

X 4 Print 4 bytes in hexadecimal, 
u 2 Print as an unsigned decimal number. 

U 4 Print long unsigned decimal. 

f 4 Print the 32 bit value as a floating point number. 
F 8 Print double floating point. 
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b 1 Print the addressed byte in octal, 
c 1 Print the addressed character. 

C 1 Print the addressed character using the following 
escape convention. Character values 000 to 040 
are printed as @ followed by the corresponding 
character in the range 0100 to 0140. The 
character @ is printed as @@. 
s n Print the addressed characters until a zero 
character is reached. 

S n Print a string using the @ escape convention. n 
is the length of the string including its zero 
terminator. 

Y 4 Print 4 bytes in date format (see ctime Q)) . 
i n Print as instructions. n is the number of bytes 
occupied by the instruction. This style of 
printing causes variables 1 and 2 to be set to the 
offset parts of the source and destination 
respectively. 

a 0 Print the value of dot in symbolic form. Symbols 
are checked to ensure that they have an 
appropriate type as indicated below. 

/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 

p 2 Print the addressed value in symbolic form using 
the same rules for symbol lookup as a. 
t 0 When preceded by an integer tabs to the next 

appropriate tab stop. For example, 8t moves to 
the next 8-space tab stop, 
r 0 Print a space, 
n 0 Print a newline. 

" "a 

• • • X/ 

Print the enclosed string. 

* Dot is decremented by the current increment. 
Nothing is printed. 

+ Dot is incremented by 1. Nothing is printed. 

- Dot is decremented by 1. Nothing is printed. 

newline 

If the previous command temporarily incremented dot, 
make the increment permanent. Repeat the previous 
command with a count of 1. 

C?/3l value mask 

Words starting at dot are masked with mask and compared 
with value until a match is found. If L is used then 
the match is for 4 bytes at a time instead of 2. If no 
match is found then dot is unchanged; otherwise dot is 
set to the matched location. If mask is omitted then 
-1 is used. 
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C?/I!w value ... 

Write the 2-byte value into the addressed location. If 
the command is W, write 4 bytes. Odd addresses are not 
allowed when writing to the subprocess address space. 

C?/]m ^ el flC?/] 

New values for (M, el, are recorded. If less than 

three expressions are given then the remaining map 
parameters are left unchanged. If the '?' or '/' is 
followed by '*' then the second segment (b2,e2,f2) of 
the mapping is changed. If the list is terminated by 
'?' or '/' then the file ( obj fil or corfil 
respectively) is used for subsequent requests. (So 
that, for example, '/m?' will cause '/' to refer to 
objfil.) 


> name 

^ot is assigned to the variable or register named. 

1 A shell is called to read the rest of the line 

following '1'. 

$ modifier 

Miscellaneous commands. The available modifiers are; 

Read commands from the file ^ and return. 

>f Send output to the file f, which is created if it 
does not exist. 

r Print the general registers and the instruction 
addressed by pc. Dot is set to pc. 

f Print the floating registers in single or double 

length. If the floating point status of ps is set 
to double (0200 bit) then double length is used 
anyway. 

b Print all breakpoints and their associated counts 
and commands. 

a ALGOL 68 stack backtrace. If address is given 

then it is taken to be the address of the current 
frame (instead of r4). If count is given then 
only the first count frames are printed. 

c C stack backtrace. If address is given then it is 
taken as the address of the current frame (instead 
of rS). If C is used then the names and (16 bit) 
values of all automatic and static- variables are 
printed for each active function. If count is 
given then only the first count frames are 
printed. 

e The names and values of external variables are 
printed. 

w Set the page width for output to address (default 
80). - 

s Set the limit for symbol matches to address 


Page 5 


(printed 8/22/83) 



ADB(l) 


Nu Machine UNIX Progranuner's Manual ADB(1} 


(default 255). 

o All integers input are regarded as octal. 

d Reset integer input as described in EXPRESSIONS. 

q Exit from adb . 

V Print all non zero variables in octal. 

m Print the address map. 

> modifier 

Manage a subprocess. Available modifiers are: 

be Set breakpoint at address . The breakpoint is 
executed count- l times before causing a stop. 

Each time the breakpoint is encountered the 
command c is executed. If this command sets dot 
to zero then the breakpoint causes a stop. 

d Delete breakpoint at address . 

r Run objfil as a subprocess. If address is given 
explicitly then the program is entered at this 
point; otherwise the program is entered at its 
standard entry point, count specifies how many 
breakpoints are to be ignored before stopping. 
Arguments to the subprocess may be supplied on the 
same line as the command. An argument starting 
with < or > causes the standard input or output to 
be established for the command. All signals are 
turned on on entry to the subprocess. 

c^ The subprocess is continued with signal £ c £, see 
signal (2). If address is given then the 
subprocess is continued at this address. If no 
signal is specified then the signal that caused 
the subprocess to stop is sent. Breakpoint 
skipping is the same as for r. 

s£ As for c except that the subprocess is single 
stepped count times. If there is no current 
subprocess then objfil is run as, a subprocess as 
for r. In this case no signal can be sent; the 
remainder of the line is treated as arguments to 
the subprocess. 

k The current subprocess, if any, is terminated. 


VARIABLES 

Adb provides a number of variables. Named variables are set 
initially by adb but are not used subsequently. Numbered 
variables are reserved for communication as follows. 

0 The last value printed. 

1 The last offset part of an instruction source. 
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2 The previous value of variable 1. 

On entry the following are set from the system header in the 
corfil . If corfil does not appear to be a core file then 
these values are set from objfil . 

b The base address of the data segment, 

d The data segment size, 

e The entry point. 

m The 'magic' number (0405, 0407, 0410 or 0411). 
s The stack segment size, 

t The text segment size. 

ADDRESSES 

The address in a file associated with a written address is 
determined by a mapping associated with that file. Each 
mapping is represented by two triples (^, el, and (b2, 

e2 , f2 ) and the fil e address corresponding to a written 
address is calculated as follows. 

bl<address < el => file address=address tfl-bl, otherwise, 

b2<address < e2 => file addre3s=addres3+f2 ~b2, 

otherwise, the requested address is not legal. In some 
cases (e.g. for programs with separated I and D space) the 
two segments for a file may overlap. If a ? or / is 
followed by an * then only the second triple is used. 

The initial setting of both mappings is suitable for normal 
a.out and core files. If either file is not of the kind 
expected then, for that file, ^ is set to 0, el is set to 
the maximum file size and fl is set to 0; in this way the 
whole file can be examined with no address translation. 

So that adb may be used on large files all appropriate 
values are kept as signed 32 bit integers. 

PILES 

/dev/mem 
/dev/swap 
a .out 
core 

SEE ALSO 

ptrace(2), a.out(5), core(5) 

DIAGNOSTICS 

'Adb' when there is no current command or format. Comments 
about inaccessible files, syntax errors, abnormal 
termination of commands, etc. Exit status is 0, unless last 
command failed or returned nonzero status. 
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bugs ^. 

A breakpoint set at the entry point is not effective on 
initial entry to the program. 

When single stepping, system calls do not count as an 
executed instruction. 

Local variables whose names are the same as an external 
variable may foul up the accessing of the external. 
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NAME 

admin - create and administer SCCS files 
SYNOPSIS 

admin C-n] C-iCname]] C-rrel] C-tCname]] 

C-ff1ag C flag-va1]] [-dflagC flag-val]] 

C-alogin] C-elogin] C-mCmrlist]] C-yCcomment]] C-h] C-z] 
files 

DESCRIPTION 

Admin is used to create new SCCS files and-change parameters 
of existing ones. Arguments to admin » which may appear in 
any order, consist of keyletter arguments, which begin with 
-, and named files (note that SCCS file names must begin 
with the characters s.). If a named file doesn't exist, it 
is created, and its parameters are initialized according to 
the specified keyletter arguments. Parameters not 
initialized by a keyletter argument are assigned a default 
value. If a named file does exist, parameters corresponding 
to specified keyletter arguments are changed, and other 
parameters are left as is. 

If a directory is named, admin behaves as though each file 
in the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does not 
begin with s.) and unreadable files are silently ignored. 

If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an 
SCCS file to be processed. Again^ non-SCCS files and 
unreadable files are silently ignored. 

The keyletter arguments are as follows. Each is explained 
as though only one named file is to be processed since the 
effects of the arguments apply independently to each named 
file. 


-n This keyletter indicates that a new SCCS 

file is to be created. 

-iCname] The name of a file from which the text 

for a new SCCS file is to be taken. The 
text constitutes the first delta of the 
file (see -r keyletter for delta 
numbering scheme). If the i keyletter 
is used, but the file name is omitted, 
the text is obtained by reading the 
standard input until an end-of-file is 
encountered. If this keyletter is 
omitted, then the SCCS file is created 
empty. Only one SCCS file may be 
created by an admin command on which the 
i keyletter is supplied. Using a single 
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rrel 


-tC name] 


- f flag 


admin to create two or more 3CCS files 
require that they be created empty (no 
-i keyletter). Note that the -i 
keyletter implies the -n keyletter. 

The rel ease into which the initial delta 
is inserted. This keyletter may be used 
only if the -i keyletter is also used. 

If the -r keyletter is not used, the 
initial delta is inserted into release 
1. The level of the initial delta is 
always 1 (by default initial deltas are 
named 1.1). 

The name of a file from which 
descriptive text for the SCCS file is to 
be taken. If the -t keyletter is used 
and admin is creating a new SCCS file 
(the -n and/or -i keyletters also used), 
the descriptive text file name must also 
be supplied. In the case of existing 
SCCS files: (1) a -t keyletter without a 
file name causes removal of descriptive 
text (if any) currently in the SCCS 
file, and (2) a -t keyletter with a file 
name causes text (if any) in the named 
file to replace the descriptive text (if 
any) currently in the SCCS file. 

This keyletter specifies a flag , and, 
possibly, a value for the flag , to be 
placed in the SCCS file. Several f 
keyletters may be supplied on a single 
admin command line. The allowable flag s 
and their values are: 


b Allows use of the -b keyletter on a 

get (1) command to create branch deltas. 

c ceil The highest release (i.e., "ceiling''), 
a number less than or equal to 9999, 
which may be retrieved by a get (1) 
command for editing. The default value 
for an unspecified c flag is 9999. 


ffloor The lowest release (i.e., ''floor''), a 
number greater than 0 but less than 
9999, which may be retrieved by a get (l) 
command for editing. The default value 
for an unspecified f flag is 1. 

dSID The default delta number (SID) to be 
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used by a get (1) command. 

i Causes the "No id keywords (ge6)" 

message issued by get (1) or delta (1) to 
be treated as a fatal error. In the 
absence of this flag, the message is 
only a warning. The message is issued 
if no sees identification keywords (see 
get (l)) are found in the text retrieved 
or stored in the SCCS file. 

j Allows concurrent get (1) commands for 

editing on the same SID of an SCCS file. 
This allows multiple concurrent updates 
to the same version of the SCCS file. 

Hist A list of releases to which deltas can 

no longer be made (get -e against one of 
these ''locked'' releases fails). The 
list has the following syntax: 

<list> <range> I <list> , <range> 

<range> RELEASE NUMBER I a 

The character a in the list is 
equivalent to specifying all releases 
for the named SCCS file. 

n Causes delta (1) to create a "null'' 

delta in each of those releases (if any) 
being skipped when a delta is made in a 
new release (e.g., in making delta 5.1 
after delta 2.7, releases 3 and 4 are 
skipped). These null deltas serve as 
''anchor points'' so that branch deltas 
may later be created from them. The 
absence of this flag causes skipped 
releases to be non-existent in the SCCS 
file preventing branch deltas from being 
created from them in the future. 

qtext User definable text substituted for all 
occurrences of the %Q% keyword in SCCS 
file text retrieved by get (1). 

mmod Modu le name of the'SCCS file substituted 
for all occurrences of the %M% keyword 
in SCCS file text retrieved by get (1). 

If the m flag is not specified, the 
value assigned is the name of the SCCS 
file with the leading s. removed. 
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ttype Type of module in the SCCS file 

substituted for all occurrences of %Y% 
keyword in SCCS file text retrieved by 
get (1). 

vC pqm ] Causes delta (1) to prompt for 

Modification Request (5^) numbers as the 
reason for creating a delta. The 
optional value specifies the name of an 
MR number validity checking program (see 
delta (1)). (If this flag is set when 
creating an SCCS file, the m keyletter 
must also be used even if its value is 
null). 


-d flag Causes removal (deletion) of the 

specified flag from an SCCS file. The 
-d keyletter may be specified only when 
processing existing SCCS files. Several 
-d keyletters may be supplied on a 
single admin command. See the -f 
keyletter for allowable flag names. 


Hist A list of releases to be "unlocked* ' . 

See the -f keyletter for a description 
of the 1 flag and the syntax of a list . 

-a loqin A login name, or numerical UNIX group 

ID, to be added to the list of users 
which may make deltas (changes) to the 
SCCS file. A group ID is equivalent to 
specifying all login names common to 
that group ID. Several a keyletters may 
be used on a single admin command line. 
As many login s, or numerical group IDs, 
as desired may be on the list 
simultaneously. If the list of users is 
empty, then anyone may add deltas. 


-e login A login name, or numerical group ID, to 

be erased from the list of users allowed 
to make deltas (changes) to the SCCS 
file. Specifying a group ID is 
equivalent to specifying all login names 
common to that group ID. Several e 
keyletters may be used on a single admin 
command line. 

-yC comment ] The comment text is inserted into the 

SCCS file as a comment for the initial 
delta in a manner identical to that of 
delta(1). Omission of the -y keyletter 
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results In a default conunent line being 
inserted in the form: 

date and. time created YY/MM/DD HHiMM:SS 
by login 

The -y keyletter is valid only if the -i 
and/or -n keyletters are specified 
(i.e., a new SCCS file is being 
- created). 

-mC mrlist ] The list of Modification Requests (MR) 

numbers is inserted into the SCCS file 
as the reason for creating the initial 
delta in a manner identical to delta (1). 
The V flag must be set and the MR 
numbers are validated if the v flag has 
a value (the name of an ^ number 
validation program). Diagnostics will 
occur if the v flag is not set or MR 
validation fails. 

-h Causes admin to check the structure of 

the SCCS file (see 3 ccsfile (5 )), and to 
compare a newly computed check-sum (the 
sum of all the characters in the SCCS 
file except those in the first line) 
with the check-sum that is stored in the 
first line of the SCCS file. 

Appropriate error diagnostics are 
produced. 

This keyletter inhibits writing on the 
file, so that it nullifies the effect of 
any other keyletters supplied, and is, 
therefore, only meaningful when 
processing existing files. 

-z The SCCS file check-sum is recomputed 

and stored in the first line of the SCCS 
file (see -h, above). 

Note that use of this keyletter on a 
truly corrupted file may prevent future 
detection of the corruption. 


FILES 

The last component of all SCCS file names must be of the 
form s. file-name . New SCCS files are given mode 444 (see 
chmod (1)). Write permission in the pertinent directory is, 
of course, required to create a file. All writing done by 
admin is to a temporary x-file, called x.file-name, (see 
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get(l))/ created with mode 444 if the admin command is 
creating a new SCCS file, or with the same mode as the SCCS 
file if it exists. After successful execution of admin , the 
SCCS file is removed (if it exists), and the x-file is 
renamed with the name of the SCCS file. This ensures that 
changes are made to the SCCS file only if no errors 
occurred. 

It is recommended that directories containing SCCS files be 
mode 755 and that SCCS files themselves be mode 444. The 
mode of the directories allows only the owner to modify SCCS 
files contained in the directories. The mode of the SCCS 
files prevents any modification at all except by SCCS 
commands. 

If it should be necessary to patch an SCCS file for any 
reason, the mode may be changed to 644 by the owner allowing 
use of ed(l). Care must be taken 1 The edited file should 
always be processed by an admin -h to check for corruption 
followed by an admin -z to generate a proper check-sum. 
Another admin -h is recommended to ensure the SCCS file is 
valid. 

Admin also makes use of a transient lock file (called 
z.file-name), which is used to prevent simultaneous updates 
to the SCCS file by different users. See get (1) for further 
information. 

SEE ALSO 

delta(l), ed(l), get(l), help(l), prs(l), what(l), 
sees file(5). 

Source Code Control System User * s Guide by L. E. Bonanni and 
C. A.Salemi. 

DIAGNOSTICS 

Use help d) for explanations. 
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NAME 

ar - archive and library maintainer 
SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive 
file. Its main use is to create and update library files as 
used by the loader. It can be used, though, for any similar 
purpose. 

Key is one character from the set drqtpmx, optionally 
concatenated with one or more of vuaibcl. Afile is the 
archive file. The names are constituent files in the 
archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the 
optional character u is used with r, then only those 
files with modified dates later than the archive files 
are replaced. If an optional positioning character 
from the set abi is used, then the posname argument 
must be present and specifies that new files are to be 
placed after (a) or before (b or i) posname . Otherwise 
new files are placed at the end. 

q Quickly append the named files to the end of the 

archive file. Optional positioning characters are 
invalid. The command does not check whether the added 
members are already in the archive. Useful only to 
avoid quadratic behavior when creating a large archive 
piece-by-piece. 

t Print a table of contents of the archive file. If no 
names are given, all files in the archive are tabled. 

If names are given, only those files are tabled. 

p Print the named files in the archive. 

m . Move the named files to the end of the archive. If a 
positioning character is present, then the posname 
argument must be present and, as in r, specifies where 
the files are to be moved I 

X Extract the named files. If no names are given, all 
files in the archive are extracted. In neither case 
does X alter the archive file. 

V Verbose. Under the verbose option, ^ gives a file- 

by-file description of the making of a new archive file 
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from the old archive and the constituent files. When 
used with t, it gives a long listing of all information 
about the files. When used with p, it precedes each 
file with a name. 

c Create. Normally will create afile when it needs 
to. The create option suppresses the normal message 
that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the 
directory /tmp. This option causes them to be placed 
in the local directory. 

FILES 

/tmp/v* temporaries 

SEE ALSO 

ld(l), ar(5), lorder(l) 

BUGS 

If the same file is mentioned twice in an argument list, it 

may be put in the archive twice. 
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NAME 

as - asseinbler 


SYNOPSIS 

as C - ] [ -o Objfile ] file ... 


DESCRIPTION 

As assembles the concatenation of the named files. If the 
optional first argument - is used, all undefined symbols in 
the assembly are treated as global. — 

The output of the assembly is left on the file objfile ; if 
that is omitted, a.out is used. It is executable if no 
errors occurred during the assembly, and if there were no 
unresolved external references. 

FILES 

/lib/as2 pass 2 of the assembler 

/tmp/atm[l-3]? temporary 
a.out object 

SEE ALSO 

ld(l), nm(l), adb(l), a.out(5) 


DIAGNOSTICS 

When an input file cannot be read, its name followed by a 
question mark is typed and assembly ceases. When syntactic 
or semantic errors occur, a single-character diagnostic is 
typed out together with the line number and the file name in 
which it occurred. Errors in pass 1 cause cancellation of 
pass 2. The possible errors are: 


) 

] 

< 

* 

a 

b 

e 

f 

g 

i 

m 

o 

P 

r 

u 

X 


Parentheses error 
Parentheses error 
String not terminated properly 
Indirection used illegally 
Error in address 

Branch instruction is odd or too remote 
Error in expression 

Error in local ('f or 'b') type symbol 
Garbage (unknown) character 
End of file inside an if 
Multiply defined synijol as label 
Word quantity assembled at odd address 
different in pass 1 and 2 
Relocation error 
Undefined symbol 
Syntax error 


BUGS 

Syntax errors can cause incorrect line numbers in following 
diagnostics. 
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NAME 

at - execute commands at a later time 


SYNOPSIS 

at time C day ] C file ] 

DESCRIPTION 

At squirrels away a copy of the named file (standard input 
default) to be used as input to ^(1) at a specified later 
time. A cd(l) command to the current directory is inserted 
at the begTnning, followed by assignments to all environment 
variables. When the script is run, it uses the user and 
group ID of the creator of the copy file. 

The time is 1 to 4 digits, with an optional following 'A', 

'p•, 'N■ or 'M' for AM, PM, noon or midnight. One and two 
digit numbers are taken to be hours, three and four digits 
to be hours and minutes. If no letters follow the digits, a 
24 hour clock time is understood. 

The optional day is either (1) a month name followed by a 
day number, or (2) a day of the week; if the word 'week' 
follows invocation is moved seven days further off. Names 
of months and days may be recognizably truncated. Examples 
of legitimate commands are 

at Sam jan 24 
at 1530 fr week 

At programs are executed by periodic execution of the 
^mmand / usr / lib / atrun from cron (8). The granularity of ^ 
depends, upon how often at run is executed. 

Standard output or error output is lost unless redirected. 


FILES 

/usr/spool/at/yy.ddd.hhhh.uu 

activity to be performed at hour hhhh of year day ddd of 
year yy . uu is a unique number. 

/usr/spool/at/lasttimedone contains hhhh for last hour of 
activity. 

/usr/spool/at/past directory of activities now in progress 
/usr/lib/atrun program that executes activities that are due 
pwd(1) 


SEE ALSO 

calendar(l), cron(8) 
DIAGNOSTICS 

Complains about various 
range. 


syntax errors and times out of 
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BUGS 

Due to the granularity of the execution of /usr/lib/atrun, 
there may be bugs in scheduling things almost exactly 24 
hours into the future. 
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NAME 

basename - strip fileneune affixes 


SYNOPSIS 

basename string C suffix ] 


DESCRIPTION 

Basename deletes any prefix ending in '/' and the suffix , if 
present in string , from string , and prints the result on the 
standard output. It is normally used inside substitution 
marks ' ' in shell procedures. 


This shell procedure invoked with the argument 
/ usr / src / cmd / cat .c compiles the named file and moves the 
output to cat in the current directory; 

cc $1 

mv a.out 'basename $1 .c' 


SEE ALSO 

sh(l) 
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be - arbitrary-precision arithmetic language 
SYNOPSIS 

be [ -c ] C -1 3 C file ... ] 

DESCRIPTION 

Be is an interactive processor for a language which 
resembles C but provides unlimited precision arithmetic. It 
takes input from any files given, then reads the standard 
input. The -1 argument stands for the name of an arbitrary 
precision math library. The syntax for be programs is as 
follows; L means letter a-z, E means expression, S means 
statement. 

Comments 

are enclosed in /* and */. 

Names 

simple variables: L 
array elements: L [ E ] 

The words 'ibase*, 'obase', and 'scale' 

Other operands 

arbitrarily long numbers with optional sign and 
decimal point. 

( E ) 

sqrt ( E ) 

length ( E ) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
L ( E , . . . , E ) 

Operators 

+ - * / % '“(% is remainder; '' is power) 

++ — (prefix and postfix; apply to names) 

ss <= >s 1= < > 

= =+ =- =/ =:% 

Statements 

E 

{S;...;S} 

if ( E ) S 

while ( E ) S 

for ( E ; E ; E ) S 

null statement 

b reak 

quit 

Function definitions 

define L ( L ,..., L ) { 
auto L, ... , L 

S; . . . S 
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return { E ) 

1 

Functions in -1 math library 
s(x) sine 
c(x) cosine 
e(x) exponential 
1(X) log 
a(x) arctangent 
j(n,x) Bessel function 

All function arguments are passed by value. 

The value of a statement that is an expression is printed 
unless the main operator is an assignment. Either 
semicolons or newlines may separate statements. Assignment 
to scale influences the number of digits to be retained on 
arithmetic operations in the manner of ^(1). Assignments 
to ibase or obase set the input and output number radix 
respectively. 

The same letter may be used as an array, a function, and a 
simple variable simultaneously. All variables are global to 
the program. 'Auto' variables are pushed down during 
function calls. When using arrays as function arguments or 
defining them as automatic variables empty square brackets 
must follow the array name. 

For example 

scale = 20 
define e(x)I 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1==1; i++){ 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 

} 

} 

defines a function to compute an approximate value of the 
exponential function and 

for(i=l; i<=10; i++) e(i) 

prints approximate values of the exponential function of the 
first ten integers. 
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Be is actually a preprocessor for dc(l), which it invokes 
automatically, unless the -c (compTTe only) option is 
present. In this case the dc input is sent to the standard 
output instead. 


FILES 

/usr/lib/lib.b mathematical library 
dc(l) desk calculator proper 

SEE ALSO 

dc(l) 

L. L. Cherry and R. Morris, BC - ^ arbitrary precision 
desk-calculator language 


BUGS 

No &&, 1 I, or 1 operators. 

For statement must have all three E's. 

Quit is interpreted when read, not when executed. 
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NAME 

bdiff - big diff 
SYNOPSIS 

bdiff filel file2 Cn] C-s] 


DESCRIPTION 

Bdiff is used in a manner analogous to diff (1) to find which 
lines must be changed in two files to bring them into 
agreement. Its purpose is to allow processing of files 
which are too large for diff . Bdiff ignores lines common to 
the beginning of both files, splits the remainder of each 
file into n-line segments, and invokes diff upon 
corresponding segments. The value of n is 3500 by default. 
If the optional third argument is given, and it is numeric, 
it is used as the value for n. This is useful in those 
cases in which 3500-line segments are too large for diff, 
causing it to fail. If filel ( file2 ) is -, the standard 
input is read. The optional -s (silent) argument specifies 
that no diagnostics are to be printed by bdiff (note, 
however, that this does not suppress possible exclamations 
by diff . If both optional arguments are specified, they 
must appear in the order indicated above. 


The output of bdiff is exactly that of diff , with line 
numbers adjusted to account for the segmenting of the files 
(that is, to make it look as if the files had been processed 
whole). Note that because of the segmenting of the files, 
bdi ff does not necessarily find a smallest sufficient set of 
file differences. 


FILES 

/tmp/bd????? 

SEE ALSO 

diff(l). 

DIAGNOSTICS 

Use help (1) for explanations. 
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NAME 

cal - print calendar 
SYNOPSIS 

cal C month 3 year 


DESCRIPTION 

Gal prints a calendar for the specified year. If a month is 
also specified, a calendar just for that month is printed. 
Year can be between 1 and 9999. The month is a number 
between 1 and 12. The calendar produced is that for England 
and her colonies. 


Try September 1752. 


BUGS 

The year is always considered to start in January even 
though this is historically naive. 

Beware that 'cal 78' refers to the early Christian era, not 
the 20th century. 
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NAME 

cat - catenate and print 
SYNOPSIS 

cat L -u ] file ... 

DESCRIPTION 

Cat reads each file in sequence and writes it on the 
standard output. Thus 

cat file 


prints the file and 

cat filel file2 >file3 

concatenates the first two files and places the result on 
the third. 


If no file is given, or if the argument is encountered, 

cat reads from the standard input. Output is buffered in 
512-byte blocks unless the standard output is a terminal or 
the —u option is present. 

SEE ALSO 

pr(l), cp(l) 


BUGS 

Beware of cat a b >a' and 'cat a b >b', which destroy input 
files before reading them. 
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NAME 

cc, pcc - C compiler 
SYNOPSIS 

cc C option ] ... file ... 
pcc C option ] ... file ... 

DESCRIPTION 

Cc is the UNIX C compiler. It accepts several types of 
arguments: 

Arguments v/hose names end with '.c' are taken to be C source 
programs; they are compiled, and each object program is left 
on the file whose name is that of the source with '.o' 
substituted for '.c'. The '.o' file is normally deleted, 
however, if a single C program is compiled and loaded all at 
one go. 

In the same way, arguments whose names end with '.s' are 
taken to be assembly source programs and are assembled, 
producing a '.o' file. 

The following options are interpreted by cc. See 1^(1) for 
load-time options. 

-c Suppress the loading phase of the compilation, and 

force an object file to be produced even if only one 
program is compiled. 

-p Arrange for the compiler to produce code which 

counts the number of times each routine is called; 
also, if loading takes place, replace the standard 
startup routine by one which automatically calls 
monitor(3) at the start and arranges to write out a 
mon . out file at normal termination of execution of 
the object program. An execution profile can then 
be generated by use of prof (1). 

-f In systems without hardware floating-point, use a 

version of the C compiler which handles floating¬ 
point constants and loads the object program with 
the floating-point interpreter. Do not use if the 
hardware is present. 

-O Invoke an object-code optimizer. 

-S Compile the named C programs, and leave the 

assembler-language output on corresponding files 
suffixed '.s'. 

-P Run only the macro preprocessor and place the result 
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for each '.c* file in a corresponding '.i' file and 
has no '#' lines in it. 

-B Run only the macro preprocessor and send the result 

to the standard output. The output is intended for 
compiler debugging; it is unacceptable as input to 
cc . 

-o output 

Name the final output file output . If this option 
is used the file 'a.out* will be left undisturbed. 

—Dnaine=def 

-D naine Define the name to the preprocessor, as if by 

'♦define*. If no definition is given, the name is 
defined as 1. 

-U name Remove any initial definition of name . 

-I dir '#include* files whose names do not begin with '/* 

are always sought first in the directory of the file 
argument, then in directories named in -I options, 
then in directories on a standard list. 


-B string 

Find substitute compiler passes in the files named 
string with the suffixes cpp, c0, cl and c2. If 
string is empty, use a standard backup version. 


-tCp012] 

Find only the designated compiler passes in the 
files whose names are constructed by a -B option. 

In the absence of a -B option, the string is taken 
to be '/usr/c/'. 

Other arguments are taken to be either loader option 
arguments, or C-compatible object programs, typically 
produced by an earlier cc run, or perhaps libraries of C- 
compatible routines. These programs, together with the 
results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name 
a.out. 

The major purpose of the 'portable C compiler', pcc , is to 
serve as a model on which to base other compilers. Pcc does 
not support options -f, -E, -B, and -t. It provides") In 
addition to the language of cc, unsigned char type data and 
initialized bit fields. 


FILES 

file.c input file 

file.o object file 
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a. out 

/tmp/ctm? 

/lib/cpp 

/lib/cC01] 

/usr/c/ocC0123 

/usr/c/ocpp 

/lib/fcC01] 

/lib/c2 

/lib/crt0.o 

/lib/mcrt0.o 

/lib/fcrtU.o 

/lib/libc.a 

/usr/include 

/trap/pc* 

/usr/lib/ccom 


loaded output 
temporaries for cc 
preprocessor 
compiler for cc 
backup compiler for cc 
backup preprocessor 
floating-point compiler 
optional optimizer 
runtime startoff 
startoff for profiling 

startoff for floating-point interpretation 
standard library, see intro(3) 
standard directory for '^tinclude' files 
temporaries for pcc 
compiler for pcc 


SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming 
Language , Prentice-Hall, 1978 
D. M. Ritchie, C Reference Manual 
monitorO), prof (ITT adb (1) ^ ld(l) 


DIAGNOSTICS 

The diagnostics produced by C itself are intended to be 
self-explanatory. Occasional messages may be produced by 
the assembler or loader. Of these, the most mystifying are 
from the assembler, ^(1), in particular 'ra', which means a 
multiply-defined external symbol (function or data). 


BUGS 

The -O optimizer was designed to work with cc; its use with 
pcc is suspect. 
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NAME 

cc86 - C compiler for the Intel iAPX86 


SYNOPSIS 

cc86 t option 3 ••• file ... 


DESCRIPTION 

Cc86 is the UNIX C compiler. It accepts several types of 
arguments; 

Arguments whose names end with '.c' are taken to be C source 
programs; they are compiled, and each object program is left 
on the file whose name is that of the source with '.b86' 
substituted for '.c'. The '.b86' file is normally deleted, 
however, if a single C program is compiled and loaded all at 
one go. 

In the same way, arguments whose names end with '.a86' are 
taken to be assembly source programs and are assembled, 
producing a '.b86' file. 

The following options are interpreted by cc86 . See ld86 (1) 
for load-time options. 


-c 


-P 


-S 


-P 



Suppress the loading phase of the compilation, and 
force an object file to be produced even if only one 
program is compiled. 

Arrange for the compiler to produce code which 
counts the number of times each routine is called; 
also, if loading takes place, replace the standard 
startup routine by one which automatically calls 
monitor (3) at the start and arranges to write out a 
mon . out file at normal termination of execution of 
the object program. An execution profile can then 
be generated by use of prof (1). (not yet 
implemented) 

Compile the named C programs, and leave the 
assembler-language output on corresponding files 
suffixed '.a86'. 

Run only the macro preprocessor and place the result 
for each '.c' file in a corresponding '.i* file and 
has no '#' lines in it. 

Run only the macro preprocessor and send the result 
to the standard output. The output is intended for 
compiler debugging; it is unacceptable as input to 
cc86. 


-o output 
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Name the final output file output » If this option 
is used the file 'a.out' will be left undisturbed. 

-D name a def 

-Dnarae Define the name to the preprocessor, as if by 

'♦define'. If no definition is given, the name is 
defined as 1 . 

-U name Remove any initial definition of name . 

«-I dir '#include' files whose names do not begin with '/' 

are always sought first in the directory of the file 
argument, then in directories named in -I options, 
then in directories on a standard list. 


-B strlng 

Find substitute compiler passes in the files named 
string with the suffixes cpp, 086 and c2. If string 
is empty, use a standard backup version. 


-tCp012] 

Find only the designated compiler passes in the 
files whose names are constructed by a —B option. 

In the absence of a -B option, the string is taken 
to be '/usr/c/'. 

Other arguments are taken to be either loader option 
arguments, or C-compatible object programs, typically 
produced by an earlier cc 86 run, or perhaps libraries of C- 
compatible routines. These programs, together with the 
results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name 
b.out. 


FILES 

file .c 
file.b 86 
b.out 
/tmp/ctm? 

/lib/cpp 
/usr/bin/c36 
/usr/lib/crt 0 .b 86 
/usr/lib/mcrt 0 .b 86 
/usr/lib/861ibc.a 
/usr/include 


input file 

object file 

loaded output 

temporaries for cc 

preprocessor 

compiler for cc 86 

runtime startoff 

startoff for profiling 

standard library, see intro (3) 

standard directory for '#include' files 


SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Prograraming 
Language , Prentice-Hall, 1978 
D. M. RTtchie, C Reference Manual 
monitor(3), prof( 1 ), ld86(lTT adb(l) 
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DIAGNOSTICS 

The diagnostics produced by C itself are intended to be 
self-explanatory. Occasional messages may be produced by 
the assembler or loader. 
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NAME 

cdc - change the delta commentary of an SCCS delta 
SYNOPSIS 

cdc -rSID C-mCmrlist]] C-yCcomment] ] files 
DESCRIPTION 

Cdc changes the delta commentary , for the SID specified by 
the -r Tceyletter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request 
(mr) ^and comment information normally specified via the 
delta (1) command (-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in 
the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does not 
begin with s.) and unreadable files are silently ignored. 

If a name of - is given, the standard input is read (see 
WARtTINGS ) ? each line of the standard input is taken to be 
the name of an SCCS file to be processed. 

Arguments to cdc , which may appear in any order, consist of 
keyletter arguments, and file names. 

All the described keyletter arguments apply independently to 
each named file: 

-r SID Used to specify the £CCS IDentification 

( SID ) string of a delta for which the 
delta commentary is to be changed. 

~m[ mrlist ] If the SCCS file has the v flag set (see 

admin (l)) then a list of MR numbers to 
be added and/or deleted in the delta 
commentary of the SID specified by the 
-r keyletter may be supplied. A null MR 
list has no effect. 

MR entries are added to the list of MRs 
in the same manner as that of delta (1). 
In order to delete an MR, precede the MR 
number with the character I (see 
EXAMPLES ). If the MR to be deleted is 
currently in the list of MRs, it is 
removed and changed into a ''comment'' 
line. A list of all deleted MRs is 
placed in the comment section of the 
delta commentary and preceded by a 
comment line stating that they were 
deleted. 
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If -m is not used and the standard input 
is a terminal, the prompt MRs? is issued 
on the standard output before the 
standard input is read; if the standard 
input is not a terminal, no prompt is 
issued. The MRs? prompt always precedes 
the comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks 
and/or tab characters. An unescaped 
new-line character terminates the MR 
list. 

Note that if the v flag has a value (see 
admin (1)), it is taken to be the name of 
a program (or shell procedure) which 
validates the correctness of the MR 
numbers. If a non-zero exit status is 
returned from the MR number validation 
program, cdc terminates and the delta 
commentary- remains unchanged. 

-yC comment ] Arbitrary text used to replace the 

comment (s) already existing for the 
delta specified by the -r keyletter. 

The previous comments are kept and 
preceded by a comment line stating that 
they were changed. A null comment has 
no effect. 

If -y is not specified and the standard 
input is a terminal, the prompt 
comments? is issued on the standard 
output before the standard input is 
read; if the standard input is not a 
terminal, no prompt is issued. An 
unescaped new-line character terminates 
the comment text. 

The exact permissions necessary to modify the SCCS file 
are documented in the Source Code Control System User's 
Guide . Simply stated, they are either (1) if you made”” 
the delta, you can change its delta commentary; or (2) 
if you own the file and directory you can modify the 
delta commentary. 


EXAMPLES 

cdc -rl.6 -m"bl78-12345 Ibl77-54321 bl79-00001" 
-ytrouble s.file 

adds bl78—12345 and bl79—00001 to the MR list, removes 
^I^^“54321 from the MR list, and adds the comment trouble to 
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delta 1.6 of s.file. 
cdc -rl.6 s.file 

MRS? Ibl77-54321 bl78-12345 bl79-00001 
comments? trouble 

does the same thing. 

WARNINGS 

If sees file names are supplied to the cdc command via the 
standard input (- on the command line), then the -m and -y 
keyletters must also be used. 


PILES 

x-file (see delta (1)) 
z-file (see delta (l)) 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 
Source eode eontrol System User 's Guide by L. E. Bonanni and 
G. A. Salemi. 


DIAGNOSTieS 

Use help (l) for explanations. 
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NAME 

cfnt - clear loaded font 
SYNOPSIS 

cfnt fontnum C window ] 


DESCRIPTION 

Cfnt clears font fontnum from window window . The font must 
have already been loaded into the window using Ifnt. Fontnum 
must be in the range 0 to 6 (7 is the default font and 
cannot be cleared). If window is not supplied it defaults 
to the window in which the command is being executed in. 


SEE ALSO 

Ifnt(l) Isfnt(l) sfnt(l) 
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NAME 

chgrp - change group 
SYNOPSIS 

chgrp group f ile ... 


DESCRIPTION 

Chgrp changes the <jroup-ID of the files to group . The group 
may be either a decimal GID or a group name found in the 
group-ID file. 


The user invoicing chgrp must belong to the specified group, 
or be the super-user. 


FILES 

/etc/group 
SEE ALSO 

chgrp{8), chown(2), passwd(5), group(5) 
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NAME 

chmod - change mode 
SYNOPSIS 

chmod mode file ... 

DESCRIPTION 

The mode of each named file is changed according to mode, 
which may be absolute or symbolic. An absolute mode is an 
octal number constructed from the OR of the following modes: 

4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod (2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[ who ] op permission [ op permission ] ... 

The who part is a combination of the letters u (for user's 
permissions), g (group) and o (other). The letter a stands 
for ugo. If who is omitted, the default is a but the setting 
of the file creation mask (see umask(2)) is taken into 
account. 

0£ can be + to add permission to the file's mode, - to take 
away permission and = to assign permission absolutelv fall 
other bits will be reset). 

Permission is any combination of the letters r (read), w 
(write), X (execute), s (set owner or group id) and t (save 
text — sticky)• Letters u, g or o indicate that permissi on 
IS to be taken from the current mode. Omitting permission 
is only useful with = to take away all permissionsT 


The first example denies write permission to others, the 
second makes a file executable; 

chmod o—w file 
chmod +x file 

symbolic modes separated by commas may be given. 
Operations are performed in the order specified. The letter 
s is only useful with u or g. 

Only the owner of a file (or the super-user) may change its 
mode. ^ 
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SEE ALSO 

ls{l), chmod(2), chown (1), stat(2), uinask(2) 


CHMOD(l) 
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NAME 

chown, chgrp - change owner or group 
SYNOPSIS 

chown owner file ... 
chgrp group file ... 


DESCRIPTION 

Chown changes the owner of the files to owner. The owner 
may be either a decimal UID or a login name found in the 
password file. 

Chgrp changes the group-ID of the files to group . The group 
may be either a decimal GID or a group name found in the 
group-ID file. 

Only the super-user can change owner or group, in order to 
simplify as yet unimplemented accounting procedures. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

chown(2), passwd(5), group(5) 
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clear - clear terminal screen 


SYNOPSIS 

clear 

DESCRIPTION 

Clear clears your screen if this is poss 
the environment for the terminal type and then in 
/ etc/termcap to figure out how to clear the screen. 


CLEAR(l) 


sable. It looks in 


FILES 


/etc/termcap terminal capability data 


BUGS 


base 
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NAME 

cmp - compare two files 
SYNOPSIS 

cmp C -1 ] C -s ] filel file2 
DESCRIPTION 

The two files are compared. (If filel is the standard 

input is used.) Under default options, cmp makes no comment 
if the files are the same; if they differ, it announces the 
byte and line number at which the difference occurred. If 
one file is an initial subsequence of the other, that fact 
is noted. 

Options: 

-1 Print the byte number (decimal) and the differing 
bytes (octal) for each difference. 

-a Print nothing for differing files; return codes only. 

SEE ALSO 

dif f(1), comm(1) 


DIAGNOSTICS 

Exit code 0 is returned for identical files, 1 for different 
files, and 2 for an inaccessible or missing argument. 


Page 1 


(printed 8/22/83) 



COL(l) Nu Machine UNIX Progranuner' e ^nual COL(l) 


col - filter reverse line feeds 

SYNOPSIS 

col C-bfx] 

DESCRIPTION 

Col reads the standard input and writes the standard output. 
It performs the line overlays implied by reverse line feeds 
(ESC-? in ASCII) and by forward and reverse half line feeds 
(ESC-9 and ESC-8). Col is particularly useful for filtering 
multicolumn output made with the '.rt* command of nroff and 
output resulting from use of the tbl (1) preprocessor. 

Although col accepts half line motions in its input/ it 
normally does not emit them on output. Instead, text that 
would appear between lines is moved to the next lower full 
line boundary. This treatment can be suppressed by the -f 
(fine) option; in this case the output from col may contain 
forward half line feeds (ESC-9), but will still never 
contain either kind of reverse line motion. 

If the -b option is given, col assumes that the output 
device in use is not capable of backspacing. In this case, 
if several characters are to appear in the same place, only 
the last one read will be taken. 

The control characters SO (ASCII code 017), and SI (016) are 
assumed to start and end text in an alternate character set. 
The character set (primary or alternate) associated with 
each t^rinting character read is remembered; on output, SO 
and SI characters are generated where necessary to maintain 
the correct treatment of each character. 

Col normally converts white space to tabs to shorten 
printing time. If the -x option is given, this conversion 
is suppressed. 

All control- characters are removed from the input except 
space, backspace, tab, return, newline, ESC (033) followed 
by one of 789, SI, SO, and VT (013). Thiis last character is 
an alternate form of full reverse line feed, for 
compatibility with some other hardware conventions. All 
other non-printing characters are ignored. 

SEE ALSO 

troffd), tbl(l), greek(l) 

BUGS 

Can't back up more than 128 lines. 

No more than 800 characters, including backspaces, on a 
line. 
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NAME 

comb - combine SCCS deltas 
SYNOPSIS 

comb C-o] C-s] C-psid] C-clist] files 
DESCRIPTION 

Comb generates a shell procedure (see ^(1)) which, when 
run, will reconstruct the given SCCS files. The 
reconstructed files will, hopefully, be smaller than the 
original files. The arguments may be specified in any 
order, but all keyletter arguments apply to all named SCCS 
files. If a directory is neimed, comb behaves as though each 
file in the directory were specified as a named file, except 
that non-SCCS files (last component of the path name does 
not begin with s.) and unreadable files are silently 
ignored. If a name of - is given, the standard input is 
read? each line of the standard input is taken to be the 
name of an SCCS file to be processed; non-SCCS files and 
unreadable files are silently ignored. 

The generated shell procedure is written on the standard 
output. 

The keyletter arguments are as follows. Each is explained 
as though only one named file is to be processed, but the 
effects of any keyletter argument apply independently to 
each named file. 

-pSID The £CCS IDentification string (SID) of the oldest 
delta to be preserved. All older deltas are 
discarded in the reconstructed file. 

-c list A list (see get (1) for the syntax of a list ) of 
deltas to be preserved. All other deltas are 
discarded. 

For each get -e generated, this argument causes the 
reconstructed file to be accessed at the release of 
the delta to be created, otherwise the reconstructed 
file would be accessed at the most recent ancestor. 
Use of the -o keyletter may decrease the size of the 
reconstructed SCCS file. It may also alter the 
shape of the delta tree of the original file. 

This argument causes comb to generate a shell 
procedure which, when run, will produce a report 
giving, for each file: the file name, size (in 
blocks) after combining, original size (also in 
blocks), and percentage change computed by; 

100 * (original - combined) / original 
It is recommended that before any SCCS files are 
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actually combined, one should use this option to 
determine exactly how much spa^e is saved by the 
condsining process. 


If no keyletter arguments are specified 
only leaf deltas and the minimal nunibe^ 
to preserve the tree. 


FILES 


s.COMB The name of the reconstructed SCCS file, 

comb????? Temporary. 


SEE ALSO 

admind), delta(l), get(l), help(l), pt 
Source Code Control System User * s Guid^ 
C. A. Salemi. 

DIAGNOSTICS 

Use help (l) for explanations. 


BUGS 


Comb may rearrange the shape of the tr^ 
not“save any space; in fact, it is pos 
reconstructed file to actually be larg4 


e of deltas. It may 
^ible for the 
r than the original. 


, comb will preserve 
of ancestors needed 


s(l), sccsfile(5). 
by L. E. Bonanni and 


u 
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NAME 

comm - select or reject lines common to two sorted files 


SYNOPSIS 

comm C - C 123 ] ] filel file2 


DESCRIPTION 

Comm reads filel and file2 , which should be ordered in ASCII 
collating sequence, and produces a three column output: 
lines only in filel ; lines only in file2 ; and lines in both 
files. The filename means the standard input. 


Flags 1, 2, or 3 suppress printing of the corresponding 
column. Thus comm -12 prints only the lines common to the 
two files; comm -23 prints only lines in the first file but 
not in the second; comm -123 is a no-op. 

SEE ALSO 

cmp(l), diff(l), uniq(l) 
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NAME 

cp - copy 

SYNOPSIS 

cp filel file2 

cp file ... directory 


DESCRIPTION 


Filel is copied onto file2 . The mode and owner of file2 are 
preserved if it already existed; the mode of the source file 


is used otherwise. 


In the second form, one or more files are copied into the 
directory with their original file-names. 

Gp refuses to copy a file onto itself. 


SEE ALSO 

cat(l), pr(l), mv(l) 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

cpio -o C acBv ] 

cpio -i C Bcdmrtuv6s ] C patterns ] 
cpio -p C adlmruv 3 directory 
DESCRIPTION 

Cpio -o (copy out) reads the standard input to obtain a list 
of path names and copies those files onto the standard 
output together with path name and status information. 

Cpio -i (copy in) extracts from the standard input (which is 
assumed to be the product of a previous cpio -o) the names 
of files selected by zero or more patterns civen in the 
name-generating notation of sh(l). In patterns > meta¬ 
characters and C**»3 match the slash / character. The 

default for patterns is * (i.e., select all files). 

Cpio -p (pass) copies out and in in a single operation. 
Destination path names are interpreted relative to the named 
directory . 

The meanings of the available options are: 

Reset access times of input files after they have been 
copied. 

Input/output is to be blocked 5,120 bytes to the record 
(does not apply to the pass option; meaningful only 
with data directed to or from /dev/rmt?). 

Directories are to be created as needed. 

Write header information in ASCII character form for 
portability. 

Interactively rename files. If the user types a null 
line, the file is skipped. 

Print a table of contents of the input. No files are 
created. 

unconditionally (normally, an older file will not 
replace a newer file with the same name). 

Verbose : causes a list of file names to be printed. 

When used with the t option, the table of contents 
looks like the output of an Is -1 command (see Is(1)). 
Whenever possible, link files rather than copying them. 
Usable only with the -p option. 

Retain, previous file modification time. This option is 
ineffective on directories that are being copied. 
Process an old (i.e., UNIX Sixth Edition format) file. 
Only useful with -i (copy in). 

Swap directory header bytes. Used when reading pdpll 
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generated cpio tapes. 


EXJVMPLES 

The first example 
into an archive; 
hierarchy; 


below copies the contents of a directory 
the second duplicates a directory 


Is 1 cpio -o >/dev/rat0 


cd olddir 

find . -print I cpio -pdl newdir 


The trivial case ''find . -print 
be handled more efficiently by: 


1 cpio 


-oB 


>/dev/rmt0'' 


can 


find . -cpio /dev/rmt0 


SEE ALSO 

ar(l), find(l), cpio(5). 


BUGS 


Path names are restricted to 128 charac 
too many unique linked files, the progr 
to keep track of them and, thereafter, 
is lost. Only the super-user can copy 


ters. 
am runs 
linking 
special 


If there are 
out of memory 
information 
files. 
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NAME 

cpp - the C language preprocessor 
SYNOPSIS 

/llb/cpp C option ... 3 C ifile C ofile 3 3 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the 
first pass of any G compilation using the cc(l) command. 

Thus the output of cpp is designed to be in a form 
acceptable as input to the next pass of the C compiler. As 
the C language evolves, cpp and the rest of the C 
compilation package will be modified to follow these 
changes. Therefore, the use of cpp other than in this 
framework is not suggested. The preferred way to invoke cpp 
is through the cc(l) command since the functionality of cpp 
may someday be moved elsewhere. See ra4(l) for a general 
macro processor. 

Cpp optionally accepts two file names as arguments. Ifile 
and ofile are respectively the input and output for the 
preprocessor. They default to standard input and standard 
output if not supplied. 

The following options to cpp are recognized: 

-P Preprocess the input without producing the line control 
information used by the next pass of the C compiler. 

-C By default, cpp strips C-style comments. If the -C 

option is specified, all comments (except those found 
on cpp directive lines) are passed along. 

-Uname 

Remove any initial definition of name , where name is a 
reserved symbol that is predefined by the particular 
preprocessor. The current list of these possibly 
reserved symbols includes; 

operating system; ibra, geos, os, tss, unix 
hardware; interdata, pdpll, u370, u3b, 

vax 

UNIX System variant; RES, RT 


-D name 

-D naine=def 

Define name as if by a fdefine directive. If no =def 
is given, name is defined as 1. 


~I dir 

Change the algorithm for searching for finclude files 
whose names do not begin with / to look in dir before 
looking in the directories on the standard list. Thus, 
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tlnclude files whose names are enclosed in will be 
searched for first in the directory of the ifile 
argument, then in directories named in -I options, and 
last in directories on a standard list. For ^include 
files whose names are enclosed in <>, the directory of 
the ifile argument is not searched. 

Two special names are understood by cpp . The name _LINE_ 

is defined as the current line number (ais. a decimal integer) 

as known by cpp , and _PILE_ is defineci as the current file 

name (as a C string) as known by cpp . Tliey can be used 
anywhere (including in macros) just as emy other defined 
name. 

All cpp directives start with lines begun by #. The 
directives are: 

#define name token-string 

Replace subsequent Instances of n^ie with token-string . 

tdefine name ( arg , ..., arg ) t.oken-str:.ng 

Notice that there can be no space lietween name and the 
(. Replace subsequent instances o;: name followed by a 
(, a list of comma separated tokens, and a ) by token¬ 
string where each occurrence of an arg in the token¬ 
string is replaced by the corresponding token in the 
comma separated list. 

tundef name 

Cause the definition of name (if any) to be forgotten 
from now on. 

♦include " filename ” 

♦include <filename> 

Include at this point the contents of filename (which 
will then be run through cpp ). VThen the < filename > 
notation is used, filename is only searched for in the 
standard places. See the -I option above for more 
detail. 

♦ line integer - constant '* filename ” 

Causes cpp to generate line controiL information for the 
next pass of the C compiler. Integer-constant is the 
line number of the next line and f;Llename is the file 
where it comes from. If " filename ' is not given, the 
current file name is unchanged. 

♦endif 

Ends a section of lines begun by a test directive (#if, 
♦ifdef, or ♦ifndef). Each test directive must have a 
matching ♦endif. 
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fifdef name 

The lines following will appear in the output if and 
only if name has been the subject of a previous #define 
without being the subject of an intervening fundef. 

♦ifndef name 

The lines following will not appear in the output if 
and only if name has been the subject of a previous 
♦define without being the subject of an intervening 
#unde£. 

♦ if constant-expression 

Lines following will appear in the output if and only 
if the constant-expression evaluates to non-zero. All 
binary non-assignment C operators, the ?: operator, the 
unary -, 1, and “ operators are all legal in constant - 

expression . The precedence of the operators is the 
same as defined by the C language. There is also a 
unary operator defined, which can be used in constant- 
expression in these two forms: defined ( name ^ or 
d«fined name * This allows the utility of ♦ifdef and 
♦ifndef in a #if directive. Only these operators, 
integer constants, and names which are known by epp 
should be used in constant-expression . In particular, 
the sizeof operator is not available. 

♦else 

Reverses the notion of the test directive which matches 
this directive. So if lines previous to this directive 
are ignored, the following lines will appear in the 
output. And vice versa. 

The test directives and the possible ♦else directives can be 

nested. 


PILES 

/usr/include standard directory for ♦include files 

SEE ALSO 

cc(l), m4(l). 

DIAGNOSTICS 

The error messages produced by epp are intended to be self- 
explanatory. The line number and filename where the error 
occurred are printed along with the diagnostic. 


NOTES 

When newline characters were found in argument list.s for 
macros to be expanded, previous versions of epp put out the 
newlines as they were found and expanded. The current 
version of epp replaces these newlines with blanks to 
alleviate problems that the previous versions had. 
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NAME 


cron - clock daemon 


SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified datek 
according to the instructions in the fil^ 
Because cron never exits/ it should be e 


This is best done by running cron from t 
process through the file /etc/rc (see ^ 


and times 
/usr/1 lb/crontab. 
|cecuted only once, 
he initialization 
it(lM)). 


The file crontab consists of lines of si 
fields are separated by spaces or tabs, 
integer patterns that specify in order: 
minute (0-59), 
hour (0-23), 
day of the month (1-31), 
month of the year (1-12), 
and day of the week (0-6, with 0=Su 


nday) 


Each of these patterns may contain: 

a number in the (respective) range 
two numbers separated by a minus (i 
inclusive range); 

a list of numbers separated by commj 
these numbers); or 
an asterisk (meaning all legal valu 


The sixth field is a string that is exec 
the specified time(s). A % in this fiel 
a new-line character. Only the first li 
end of line) of the command field is exe 
The other lines are made available to th 
standard input. 

Cron examines crontab once a minute to s 
changed; if it has, cron reads it. Thus 
minute for entries to become effective. 


FILES 


/usr/lib/crontab 
/usr/adm/cronlog 

SEE ALSO 

init(IM), sh(1). 

DIAGNOSTICS 

A history of all actions by cron are rec^orded in 
/usr/adm/cronlog. 


CRON(IM) 


; fields each. The 
The first five are 


indicated above; 
ndicating an 

las (meaning all of 

es). 


uted by the shell at 
a is translated into 
ne (up to a % or the 
GUted by the shell, 
e command as 


be if it has 
it takes only a 


Page 1 


(printed 8/22/83) 



CRON(IM) 


Nu Machine UNIX Programmer's Manual 


CRON(IM) 


BUGS 

Cron reads crontab only when it has changed, but it reads 
the in-core version of that table once a minute. A more 
efficient algorithm could be used. The overhead in running 
cron is about one percent of the CPU, exclusive of any 
commands executed by cron. 
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NAME 


crypt - encode/decode 


SYNOPSIS 

crypt C password ] 

DESCRIPTION 

Crypt reads from the standard input and 
standard output. The password is a key 
particular transformation. I? no passwo 
demands a key from the terminal and turn 
the key is being typed in. Crypt encryp-^ 
the same key: 

crypt key <clear >cypher 
crypt key <cypher I pr 

will print the clear. 

Files encrypted by crypt are compatible \|rith those treated 
by the editor ed in encryption mode. 


CRYPT(l) 


writes on the 
that selects a 
jrd is given, crypt 
off printing while 
s and decrypts with 


The security of encrypted files depends 
the fundamental method must be hard to s 
of the key space must be infeasible; 'sn 
keys or cleartext can become visible mus-t 


n three factors: 
dive; direct search 
eak paths' by which 
be minimized. 


Crypt implements a one-rotor machine des 
lines of the German Enigma, but with a 24 
Methods of attack on .such machines are kn 
widely; moreover the amount of work requ 
large. 


The transformation of a key into the internal settings of 
the machine is deliberately designed to 'oe expensive, i.e 
to take a substantial fraction of a second to compute 
However, if keys are restricted to (say) 
letters, then encrypted files can be rea 
a substantial fraction of five minutes o 


^gned along the 
6-element rotor, 
own, but not 
ired is likely to be 


three lower-case 
by expending only 
machine time. 


Since the key is an argument to the crypiL command, it is 
potentially visible to users executing ££r(l) or a 
derivative. To minimize this possibility^ crypt takes care 
to destroy any record of the key iiomedia-tiely upon entry. No 
doubt the choice of keys and key security^ are the most 
vulnerable aspect of crypt . 


FILES 

/dev/tty for typed key 
SEE ALSO 

ed(l), makekey(3) 
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BUGS 

There is no warranty of merchantability nor any warranty of 
fitness for a particular purpose nor any other warranty, 
either express or implied, as to the accuracy of the 
enclosed materials or as to their suitability for any 
particular purpose. Accordingly, Bell Telephone 
Laboratories assumes no responsibility for their use by the 
recipient. Further, Bell Laboratories assumes no 
obligation to furnish any assistance of any kind whatsoever, 
or to furnish any additional information or documentation. 
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NAME 

csh - a shell (command interpreter) with C-like syntax 


SYNOPSIS 

csh C -cefinstvVxX ] C arg ... ] 

DESCRIPTION 

Csh is a command language interpreter. It begins by 
executing commands from the file '.cshrc' in the home 
directory of the invoker. If this is a login shell then it 
also executes commands from the file '.login' there. In the 
normal case, the shell will then begin reading conmands from 
the terminal, prompting with '% '. Processing of arguments 
and the use of the shell to process files containing command 
scripts will be described later. 

The shell then repeatedly performs the following actions: a 
line of command input is read and broken into words . This 
sequence of words is placed on the command history list and 
then parsed. Finally each command in the current line is 
executed. 

V'Oien a login shell terminates it executes commands from the 
file '.logout' in the users home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs 
with the following exceptions. The characters 'I' 

'<• '>' '(' ')' form separate words. If' doubled in 
'll', '<<• or '>>' these pairs form single words. These 
parser metacharacters may be made part cf other words, or 
prevented their special meaning, by preceding them with '\'. 
A newline preceded by a '\' is equivalent to a blank. 

In addition strings enclosed in matched pairs of quotations, 
''', or form parts of a word; metacharacters in 

these strings, including blanks and tabs, do not form 
separate words. These quotations have semantics to be 
described subsequently. Within pairs of: '' or '"* 
characters a newline preceded by a '\' gives a true newl'ine 
character. 

When the shell's input is not a terminal, the character '#' 
introduces a comment which continues to the end of the input 
line. It is prevented this special meaning when preceded by 
'\' and in quotations using ''', and 

Commands 

A simple command is a sequence of words, the first of which 
specifies the command to be executed, simple command or a 
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sequence of simple commands separated by 'i' characters 
forms a pipeline. The output of each command in a pipeline 
is connected to the input of the next. Sequences of 
pipelines may be separated by and are then executed 

sequentially. A sequence of pipelines may be executed 
without waiting for it to terminate by following it with an 
'&*. Such a sequence is automatically prevented from being 
terminated by a hangup signal; the nohup command need not be 
used. 

Any of the above may be placed in '(' ')' to form a simple 
command (which may be a component of a pipeline, etc.) It is 
also possible to separate pipelines with 'll* or '&&' 
indicating, as in the C language, that the second is to be 
executed only if the first fails or succeeds respectively. 
(See Expressions .) 

Substitutions 

V7e now describe the various transformations the shell 
performs on the input in the order in which they occur. 

History substitutions 

History substitutions can be used to reintroduce sequences 
of words from previous commands, possibly performing 
modifications on these words. Thus history substitutions 
provide a generalization of a redo function. 

History substitutions begin with the character 'i' and may 
begin anywhere in the input stream if a history substitution 
is not already in progress. This 'I' may be preceded by an 
'\' to prevent its special meaning; a 'I' is passed 
unchanged when it is followed by a blank, tab, newline, 
or '('. History substitutions also occur when an input line 
begins with 'T*. This special abbreviation will be 
described later. 

Any input line which contains history substitution is echoed 
on the terminal before it is executed as it could have been 
typed without history substitution. 

Commands input from the terminal \^hich consist of one or 
more words are saved on the history list, the size of which 
is controlled by the history variable. The previous command 
is always retained. Commands are numbered sequentially from 


For definiteness, consider the following output from the 
history command; 

9 write michael 
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10 ex write.c 

11 cat oldwrite.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not 
usually necessary to use event numbers, but the current 
event number can be made part of the prqmpt by placing an 
'l* in the prompt string. 

With the current event 13 we can refer t.o previous events by 
event number 'Ill', relatively as in '1-2' (referring to the 
same event), by a prefix of a command word as in 'id' for 
event 12 or 'Iw' for event 9, or by a string contained in a 
word in the command as in 'I?mic?' also referring to event 
9. These forms, without further modification, simply 
reintroduce the words of the specified events, each 
separated by a single blank. As a special case 'll' refers 
to the previous command; thus 'll' alone is essentially a 
redo . The form '!#' references the currant command (the one 
being typed in) . It allows a word to be: selected from 
further left in the line, to avoid retyping a long name, as 
in ' I #: 1' . 

To select words from an event we can follow the event 
specification by a ':' and a designator for the desired 
words. The words of a input line are numbered from 0, the 
first (usually command) word being 0, the second word (first 
argument) being 1, etc. The basic word designators are: 

0 first (command) word 

n n'th argument 

T first argument, i.e. 'l' 

$ last argument 

% word matched by (immediately preceding) ?£? search 

3c-y range of words 

abbreviates '0-y' 

* abbreviates 't-?', or nothing if only 1 word in event 
X* abbreviates 

X- like 'jc* * but omitting word '$' 

The ':' separating the event specification from the word 
designator can be omitted if the argument selector begins 
with a 't', '*' or '%'. After the optional word 

designator can be placed a sequence of modifiers, each 
preceded by a The following modifiers are defined; 

h Remove a trailing pathname component, leaving the head. 

r Remove a trailing '.xxx' component, leaving the root name. 

s/^/^/ Substitute ^ for r 

t Remove all leading pathname components, leaving the tail. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. 'g&'. 
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p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 
X Like q, but break into words at blanks, tabs and newlines. 

Unless preceded by a 'g* the modification is applied only to 
the first modifiable word. In any case it is an error for 
no word to be applicable. 

The left hand side of substitutions are not regular 
expressions in the sense of the editors, but rather strings. 

Any character may be used as the delimiter in place of '/'? 
a '\' quotes the delimiter into the 1 and r strings. The 
character in the right hand side is replaced by the text 
from the left. A '\' quotes also. A null ^ uses the 

previous string either from a 1 or from a contextual scan 
string £ in '!?£?'. The trailTng delimiter in the 
substitution may be omitted if a newline follows immediately 
as may the trailing '?' in a contextual scan. 

A history reference may be given without an event 
specification, e.g. '1$'. In this case the reference is to 
the previous command unless a previous history reference 
occurred on the same line in which case this form repeats 
the previous reference. Thus 'l?foo?t 1$' gives the first 
and last arguments from the command matching '?foo?'. 

A special abbreviation of a history reference occurs when 
the first non-blank character of an input line is a 't*. 

This is equivalent to 'l:sT' providing a convenient 
shorthand for substitutions on the text of the previous 
line. Thus 'tlbtlib* fixes the spelling of 'lib' in the 
previous command. Finally, a history substitution may be 
surrounded with '{' and '}' if necessary to insulate it from 
the characters which follow. Thus, after 'Is -Id ~paul' we 
might do 'l{l}a' to do 'Is -Id “paula', while 'Ila' would 
look for a command starting 'la'. 

Quotations with ' and " 

The quotation of strings by ''' and '"' can be used to 
prevent all or some of the remaining substitutions. Strings 
enclosed in ''' are prevented any further interpretation. 

Strings enclosed in are yet variable and command 

expanded as described below. 

In both cases the resulting text becomes (all or part of) a 
single word; only in one special case (see Command 
Substitution below) does a '"' quoted string yield parts of 
more than one word; '' quoted strings never do. 

Alias substitution 
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The shell maintains a list of aliases which can be 
established, displayed and modified by the alias and unalias 
commands* After a command line is scanned, it is parsed 
into distinct commands and the first word of each command, 
left-to-right, is checked to see if it has an alias. If it 
does, then the text which is the alias fbr that command is 
reread with the history mechanism available as though that 
command were the previous input line. The resulting words 
replace the command and argument list. If no reference is 
made to the history list, then the argiament list is left 
unchanged. 

Thus if the alias for 'is' is 'Is -1' the command 'Is /usr' 
would map to 'is -1 /usr', the argument list here being 
undisturbed. Similarly if the alias for lookup^ was grep 
iT /etc/passwd' then 'lookup bill' would map to grep bill 
/etc/passwd'. 

If an alias is found, the word transformation of the input 
text is performed and the aliasing process begins again on 
the reformed input line. Looping is prevented if the first 
word of the new text is the same as the old by flagging it 
to prevent further aliasing. Other loops are detected and 
cause an error. 

Note that the mechanism allows aliases to introduce parser 
trietasyntax. Thus we can 'alias print 'pr \l* I Ipr' ' to 
make a command which pr 's its arguments to the line printer. 

Variable substitution 

The shell maintains a set of variables, each of which has as 
value a list of zero or more words. Some of these variables 
are set by the shell or referred to by it. For instance, 
the argv variable is an image of the shesll's argument list, 
and words of this variable's value are referred to in 
special ways. 

The values of variables may be displayed and changed by 
using the set and unset commands. Of tlie variables referred 
to by the shell a number are toggles; the shell does not 
care what their value is, only whether t:hey are set or not. 
For instance, the verbose variable is a toggle which causes 
command input to be echoed. The setting of this variable 
results from the -v command line option., 

Other operations treat variables numerically. The '@' 
command permits numeric calculations to be performed and the 
result assigned to a variable. Variables values are, 
however, always represented as (zero or more) strings. For 
the purposes of numeric operations, the null string is 
considered to be zero, and the second and subsequent words 
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of multiword values are ignored. 

After the input line is aliased and parsed, and before each 
command is executed, variable substitution is performed 
keyed by characters. This expansion can be prevented by 
preceding the with a '\' except within '"'s where it 
always occurs, and within '“s where it never occurs. 

Strings quoted by are interpreted later (see Command 
substitution below) so substitution does not occur there 
until later, if at all. A is passed unchanged if 

followed by a blank, tab, or end-of-line. 

Input/output redirections are recognized before variable 
expansion, and are variable expanded separately. Otherwise, 
the command name and entire argument list are expanded 
together. It is thus possible for the first (command) word 
to this point to generate more than one word, the first of 
which becomes the command name, and the rest of which become 
arguments. 

Unless enclosed in '"* or given the ':q' modifier the 
results of variable substitution may eventually be command 
and filename substituted. Within a variable whose value 
consists of multiple words expands to a (portion of) a 
single word, with the words of the variables value separated 
by blanks. When the ':q* modifier is applied to a 
substitution the variable will expand to multiple words with 
each word separated by a blank and quoted to prevent later 
command or filename substitution. 

The following metasequences are provided for introducing 
variable values into the shell input. Except as noted, it 
is an error to reference a variable which is not set. 

$name 
${name} 

Are replaced by the words of the value of variable 
name , each separated by a blank. Braces insulate name 
from following characters which would otherwise be part 
of it. Shell variables have names consisting of up to 
20 letters, digits, and underscores. 

If name is not a shell variable, but is set in the 
environment, then that value is returned (but ; modifiers 
and the other forms given below are not available in this 
case) . 

?name[selector] 

${name[selector]} 

May be used to select only some of the words from the 
value of name . The selector is subjected to 
substitution and may consist of a single number or two 
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numbers separated by a The first word of a 

variables value is numbered '1*. If the first number 
of a range is omitted it defaults to If the last 

member of a range is omitted it defaults to '$#name'. 
The selector selects all words. It is not an error 
for a range to be empty if the second argument is 
omitted or in range. 

$#name 
${#name} 

Gives the number of words in the variable. This is 
useful for later use in a ' Cselect<5r] ' . 

$0 

Substitutes the name of the file from which command 
input is being read. An error occurs if the name is 
not known. 

$number 
${number} 

Equivalent to '$argvCnumber]*. 

$* 

Equivalent to '$argvC*]'. 

The modifiers ':h', ':t', *:r', ':q' and 'jx' may be applied 
to the substitutions above as may ':gh', ':gt' and ':gr*. 

If braces appear in the command form then the 

modifiers must appear within the braces| The current 
implementation allows only one modifier on each 
expansion. 

The following substitutions may not be modified with 
modifiers. 

$?name 
${?name} 

Substitutes the string '1' if name is set, '0' if it is 
not. 

$?0 

Substitutes '1' if the current input filename is know, 
'0' if it is not. 

$$ 

Substitute the (decimal) process number of the (parent) 
shell. 

Command and filename substitution 

The remaining substitutions, command anci filename 
substitution, are applied selectively to the arguments of 
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builtin conunands. This means that portions of expressions 
which are not evaluated are not subjected to these 
expansions. For commands which are not internal to the 
shell, the command name is substituted separately from the 
argument list. This occurs very late, after input-output 
redirection is performed, and in a child of the main shell. 

Command substitution 

# • 

Command substitution is indicated by a command enclosed in 

The output from such a command is normally broken into 
separate words at blanks, tabs and newlines, with null words 
being discarded, this text then replacing the original 
strixig. Within '"'s, only newlines force new words; blanks 
and tabs are preserved. 

In any case, the single final newline does not force a new 
word. Note that it is thus possible for a command 
substitution to yield only part of a word, even if the 
command outputs a complete line. 

Filename substitution 

If a word contains any of the characters '?', '[' or 

'{'or begins with the character then that word is a 

candidate for filename substitution, also known as 
'globbing'. This word is then regarded as a pattern, and 
replaced with an alphabetically sorted list of file names 
which match the pattern. In a list of words specifying 
filename substitution it is an error for no pattern to match 
an existing file name, but it is not required for each 
pattern to match. Only the metacharacters '*', '?* and 
imply pattern matching, the characters and being 

more akin to abbreviations. 

In matching filenames, the character at the beginning of 

a filename or immediately following a '/', as well as the 
character '/* must be matched explicitly. The character 
matches any string of characters, including the null string. 
The character '?' matches any single character. The 
sequence matches any one of the characters enclosed. 

Within a pair of characters separated by 

matches any character lexically between the two. 

The character at the beginning of a filename is used to 

refer to home directories. Standing alone, i.e. it 

expands to the invokers home directory as reflected in the 
value of the variable home . When followed by a name 
consisting of letters, digits and characters the shell 
searches for a user with that name and substitutes their 
home directory; thus '~ken' might expand to '/usr/ken' and 
'~ken/chraach' to '/usr/ken/chmach'. If the character is 
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followed by a character other than a letter or '/' or 
appears not at the beginning of a word, it is left 
undisturbed. 

The metanotation 'a{b,c,d}e' is a shorthand for 'abe ace 
ade'. Left to right order is preserved, with results of 
matches being sorted separately at a low level to preserve 
this order. This construct may be nestijd. Thus 
'“source/sl/{oldls,ls}.c’ expands to '/usr/source/sl/oldls.c 
/usr/source/sl/ls.c' whether or not these files exist 
without any chance of error if the home directory for 
'source* is '/usr/source'. Similarly '../{memo,*box}' might 
expand to '../memo ../box ../mbox*. (Note that 'memo* was 
not sorted with the results of matching '*box*.) As a 
special case 'P, and '{}* are passed undisturbed. 

Input/output 

The standard input and standard output of a command may be 
redirected with the following syntax: 

< name 

Open file name (which is first variable, command and 
filename expanded) as the standard input. 

<< word 

Read the shell input up to a line \/hich is identical to 
word . Word is not subjected to variable, filename or 
command substitution, and each inpiit line is compared 
to word before any substitutions are done on this input 
line. Unless a quoting '\', ['* or appears in 

word variable and command substitution is performed on 
the intervening lines, allowing '\f to quote '\* 

and '''. Commands which are substituted have all 
blanks, tabs, and newlines preserved, except for the 
final newline which is dropped. The resultant text is 
placed in an anonymous temporary file which is given to 
the command as standard input. 

> name 

>I name 

> & name 

> & I name 

The file name is used as standard output. If the file 
does not exist then it is created; if the file exists, 
its is truncated, its previous contents being lost. 

If the variable noclobber is set, 1:hen the file must 
not exist or be a character special, file (e.g. a 
terminal or '/dev/null*) or an error results. This 
helps prevent accidental destruction of files. In this 
case the 'I* forms can be used and suppress this check. 
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The forms involving route the diagnostic output 
into the specified file as well as the standard output. 
Name is expanded in the same way as '<* input filenames 
are. 

> > name 
>>& name 

> >I name 

> > & I name 

Uses file name as standard output like '>' but places ' 
output at the end of the file. If the variable 
noclobber is set, then it is an error for the file not 
to exist unless one of the '1' forms is given. 

Otherwise similar to '>'. 

If a command is run detached (followed by '&') then the 
default standard input for the command is the empty file 
'/dev/null*. Otherwise the command receives the environment 
in which the shell was invoked as modified by the input- 
output parameters and the presence of the command in a 
pipeline. Thus, unlike some previous shells, commands run 
from a file of shell commands have no access to the text of 
the commands by. default; rather they receive the original 
standard input of the shell. The '<<' mechanism should be 
used to present inline data. This permits shell command 
scripts to function as components of pipelines and allows 
the shell to block read its input. 

Diagnostic output may be directed through a pipe with the 

standard output. Simply use the form ']&' rather than just 
' I • 


Expressions 


A number of the builtin commands (to be described 
subsequently) take expressions, in which the operators are 
similar to those of C, with the same precedence. These 
expressions appear in the @, exit , if , and while commands. 
The following operators are available; 

I I && 1 tst==i=<=>=<><<>>+_ 

/%!"'() 


Here the precedence increases to the right, '==' and 

'<■ and '>', '<<’ and '>>’, '+■ and '/' 

and '%' being, in groups, at the same level. The '==' and 
'!=' operators compare their arguments as strings, all 
others operate on numbers. Strings which begin with '0' are 
considered octal numbers. Null or missing arguments are 
considered '0'. The result of all expressions are strings, 
which represent decimal numbers. It is important to note 
that no two components of an expression can appear in the 


Page 10 


(printed 8/22/83) 



CSH(l) 


Nu Machine UNIX Programmer's 


nual 


CSH(l) 


same wordy except when adjacent to components of expressions 
which are syntactically significant to the parser ('&' 

'<• '>* '(• ')•) they should be surrounded by spaces. 

Also available in expressions as primitive operands are 
command executions enclosed in '{' and ‘}' and file 
enquiries of the form '-1^ name' where is one of: 

r read access 

w write access 

X execute access 

e existence 

o ownership 

2 zero size 

f plain file 

d directory 

The specified name is command and filename expanded and then 
tested to see if it has the specified relationship to the 
real user. If the file does not exist or is inaccessible 
then all enquiries return false, i.e. 'l3'. Command 
executions succeed, returning true, i.e. '1', if the command 
exits with status 0, otherwise they fail, returning false, 
i.e. '0'. If more detailed status information is required 
then the command should be executed outside of an expression 
and the variable status examined. 

Control flow 

The shell contains a number of commands which can be used to 
regulate the flow of control in command files (shell 
scripts) and (in limited but useful ways) from terminal 
input. These commands all operate by forcing the shell to 
reread or skip in its input and, due to the implementation, 
restrict the placement of some of the commands. 

The fpreach , switch , and while statements, as well as the 
if-then-else form of the statement require that the major 
keywords appear in a single simple command on an input line 
as shown below. 

If the shell's input is not seekable, the shell buffers up 
input whenever a loop is being read and performs seeks in 
this internal buffer to accomplish the rereading implied by 
the loop. (To the extent that this allows, backward goto's 
will succeed on non-seekable inputs.) 

Builtin commands 

Builtin commands are executed within the shell. If a 
builtin command occurs as any component of a pipeline except 
the last then it is executed in a subshell. 
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alias 

alias name 

alias name wordlist 

The first form prints all aliases'. The second form 
prints the alias for name. The final form assigns the 
specified wordlist as the alias of name ; wordlist is 
command and filename substituted. Name is not allowed 
to be alias or unalias 

alloc 

Shows the amount of dynamic core in use, broken down 
into used and free core, and address of the last 
location in the heap. With an argument shows each used 
and free block on the internal dynamic memory chain 
indicating its address, size, and whether it is used or 
free. This is a debugging command and may not work in 
production versions of the shell; it requires a 
modified version of the system memory allocator. 


break 

Causes execution to resume after the end of the nearest 
enclosing forall or while . The remaining commands on 
the current line are executed. Multi-level breaks are 
thus possible by writing them all on one line. 


break sw 

Causes a break from a switch , resuming after the endsw . 
case label: 

A label in a switch statement as discussed below. 


cd 

cd name 
chdir 

chdir name 

Change the shells working directory to directory name. 
If no argument is given then change to the home 
directory of the user. 

If name is not found as a subdirectory of the current 

directory (and does not begin with '/', or 

then each component of the variable cdpath is checked to see 

if it has a subdirectory name . Finally, if all else fails 

but name is a shell variable whose value begins v/ith 

then this is tried to see if it is a directory. 

continue 

Continue execution of the nearest enclosing while or 
foreach . The rest of the commands on the current line 
are executed. 

default: 
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Labels the default case in a switch statement. The 
default should come after all case labels. 

echo wordllst 

The specified words are written to the shells standard 
output. A '\c‘ causes the echo to complete without 
printing a newline, akin to the '\i:' in nroff (1). A 
'\n' in wordlist causes a newline to be printed. 
Otherwise the ^ords are echoed, sejparated by spaces. 

else 

end 

endif 

endsw 

See the description of the foreach , if , switch , and 
while statements below. 

exec command 

The specified command is executed in place of the 
current shell. 

exit 

exit(expr) 

The shell exits either with the value of the status 
variable (first form) or with the value of the 
specified expr (second form). 

foreach name (wordlist) 

• • • 

end 

The variable name is successively set to each member of 
wordlist and the sequence of commands between this 
command and the matching end are e}:ecuted. (Both 
foreach and end must appear alone on separate lines.) 

The builtin command continue may b<s used to continue 
the loop prematurely and the built;.n command break to 
terminate it prematurely. When this command is read 
from the terminal, the loop is read up once prompting 
with '?' before any statements in 1:he loop are 
executed. If you make a mistake typing in a loop at 
the terminal you can rub it out. 

glob wordlist 

Like echo but no '\' escapes are rescognized and words 
are delimited by null characters in the output. Useful 
for programs v/hich wish to use the shell to filename 
expand a list of words. 

goto word 

The specified word is filename and command expanded to 
yield a string of the form 'label*J The shell rewinds 
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its input as much as possible and searches for a line 
of the form 'label:' possibly preceded by blanks or 
tabs. Execution continues after the specified line. 

history 

Displays the history event list, 
if (expr) command 

If the specified expression evaluates true, then the 
single command with arguments is executed. Variable 
substitution on command happens early, at the same time 
it does for the rest of the ^ command. Command must 
be a simple command, not a pipeline, a command list, or 
a parenthesized command list. Input/output redirection 
occurs even if expr is false, when command is not 
executed (this is a bug). 

if"(expr) then 

• • • 

else if (expr2) then 

• • • 

else 

• • • 

endif 

If the specified expr is true then the commands to the 
first else are executed; else if expr2 is true then the 
commands to the second else are executed, etc. Any 
number of else~if pairs are possible; only one endif is 
needed. The else part is likewise optional. (The 
words else and endif must appear at the beginning of 
input lines; the if must appear alone on its input line 
or after an else .T" 

login 

Terminate a login shell, replacing it with an instance 
of /bin/login. This is one way to log off, included for 
compatibility with /bin/sh. 

logout 

Terminate a login shell. Especially useful if 
iqnoreeof is set. 

nice 

nice +number 
nice command 
nice +number command 

The first form sets the nice for this shell to 4. The 
second form sets the nice to the given number. The 
final two forms run command at priority 4 and number 
respectively. The super-user may specify negative 
niceness by using 'nice -number ...'. Command is 
always executed in a sub-shell, and the restrictions 


Page 14 


(printed 8/22/83) 



CSH(l) Nu Machine UNIX Programmer's Manual CSH(1} 


place on commands in simple ij| statements apply, 
nohup 

nohup command 

The first form can be used in shell scripts to cause 
hangups to be ignored for the remaiider of the script. 
The second form causes the specified command to be run 
* with hangups ignored. On the Computer Center systems 
at UC Berkeley, this also submits t]ie process. Unless 
the shell is running detached, noBu] ? has no effect. 

All processes detached with ''&*' are automatically 
nohup * ed . (Thus, nohup is not really needed.) 

onintr 
onintr - 
onintr label 

Control the action of the shell on interrupts. The 
first form restores the default action of the shell on 
interrupts which is to terminate shall scripts or to 
return to the terminal command input level. The second 
form 'onintr causes all interrupts to be ignored. 

The final form causes the shell to execute a goto 
label* when an interrupt is receive! or a child process 
terminates because it was interrupted. 

In any case, if the shell is running detached and 
interrupts are being ignored, all farms of onintr have 
no meaning and interrupts continue to be ignored by the 
shell and all invoked commands. 

rehash 

Causes the internal hash table of the contents of the 
directories in the path variable to be recomputed. 

This is needed if new corranands are added to directories 
in the path while you are logged in. This should only 
be necessary if you add commands to one of your own 
directories, or if a systems programmer changes the 
contents of one of the system directories. 

repeat count command 

The specified command which is subject to the same 
restrictions as the command in the one line if 
statement above, is executed count times, ijo 
redirections occurs exactly once, even if count is 0. 

set 

set- name 

set name=word 

set nameCindex3=word 

set name=(wordlist) 

The first form of the command shows the value of all 
shell variables. Variables which have other than a 
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single word as value print as a parenthesized word 
list. The second form sets name to the null string. 

The third form sets name to the single word. The fourth 
form sets the index ' th component of name to word; this 
component must already exist. The final form sets name 
to the list of words in wordlist . In all cases the 
value is command and filename expanded. 

These arguments may be repeated to set multiple values 
in a single set command. Note however, that variable 
expansion happens for all arguments before any setting 
occurs. 

satenv name value 

(Version 7 systems only.) Sets the value of environment 
variable name to be value , a single string. Useful 
environment variables are 'TERM' the type of your 
terminal and 'SHELL* the shell you are using. 

shift 

shift variable 

The members of argv are shifted to the left, discarding 
argv [l]. It is an error for argv not to be set or to 
have less than one word as value. The second form 
performs the same function on the specified variable. 

source name 

The shell reads commands from name. Source commands may 
be nested; if they are nested too deeply the shell may 
run out of file descriptors. An error in a source at 
any level terminates all nested source commands. Input 
during source commands is never placed on the history 
list. 

switch (string) 
case strl: 

• • • 

breaksw 
• • • 

default: 

• • • 

breaksw 

endsw 

Each case label is successively matched, against the 
specified string which is first command and filename 
expanded. The file metacharacters '*', '?' and 
may be used in the case labels, which are variable 
expanded. If none of the labels match before a 
'default* label is found, then the execution begins 
after the default label. Each case label and the 
default label must appear at the beginning of a line. 
The command breaksw causes execution to continue after 
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the endsw. Otherwise control may i:all through case 
labels and default labels as in C. If no label matches 
and there is no default, execution continues after the 
endsw * 

time 

time command 

With no argument, a summary of time used by this shell 
’and its children is printed. If eirguments are given 
the specified simple command is tjLmed and a time 
summary as described under the tirte variable is 
printed. If necessary, an extra shell is created to 
print the time statistic when the command completes. 

umask 

umask value 

The file creation mask is displayed (first form) or set 
to the specified value (second form). The mask is 
given in octal. Common values foir the mask are 002 
giving all access to the group and read and execute 
access to others or 022 giving al]. access except no 
write access for users in the group or others. 

unalias pattern 

All aliases whose names match the specified pattern are 
discarded. Thus all aliases are removed by 'unalias 
*'. It is not an error for nothing to be unaliased . 

unhash 

Use of the internal hash table to speed location of 
executed programs is disabled. 

unset pattern 

All variables whose names match the specified pattern 
are removed. Thus all variables are removed by 'unset 
*'; this has noticeably distasteful side-effects. It 
is not an error for nothing to be unset . 

wait 

All child processes are waited for. It the shell is 
interactive, then an interrupt can disrupt the wait, at 
which time the shell prints names and process numbers 
of all children known to be outstanding. 

while (expr) 

« • « 

end 

^fhile the specified expression evaluates non-zero, the 
commands between the while and the matching end are 
evaluated. Break and continue may be used to terminate 
or continue the loop prematurely. (The while and end 
must appear alone on their input Lines.) Prompting 
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occurs here the first time through the loop as for the 
foreach statement if the input is a terminal. 

@ 

@ name = expr 
@ name[index] = expr 

The first form prints the values of all the shell 
variables. The second form sets the specified name to 
the value of expr . If the expression contains '<', 
or 'I' then at least this part of the expression 
must be placed within '(' ')*. The third form assigns 
the value of expr to the index'th argument of name. 

Both name and its index * th component must already 
exist. 

The operators etc are available as in C. 

The space separating the name from the assignment 
operator is optional. Spaces are, however, mandatory 
in separating components of expr which would otherwise 
be single words. 

Special postfix '++' and '—' operators increment and 
decrement name respectively, i.e. i++'. 

Pre-defined variables 

The following variables have special meaning to the shell. 

Of these, argv , child , home , path, prompt, shell and status 
are always set by the shell. Except for child and status 
this setting occurs only at initialization; these variables 
will not then be modified unless this is done explicitly by 
the user. 

The shell copies the environment variable PATH into the 
variable path , and copies the value back into the 
environment whenever path is set. Thus is is not necessary 
to worry about its setting other than in the file .cshrc as 
inferior csh processes will import the definition of path 
from the environment. (It could be set once in the .login 
except that commands through net (l) would not see the 
definition.) 

argv Set to the arguments to the shell, it is from 

this variable that positional parameters are 
substituted, i.e. '$1' is replaced by 
'$argv[l]', etc. 

cdpath Gives a list of alternate directories 

searched to find subdirectories in chdir 
commands. 

child The process number printed when the last 
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command was forked with.'&'. This variable 
is unset when this process terminates. 

echo Set when the -x command line option is given. 

Causes each command and its arguments to be 
echoed just before it is executed. For non- 
builtin commands all expansions occur before 
echoing. Builtin commands are echoed before 
command and filename substitution, since 
these substitutions are then done 
selectively. 

histchars Can be assigned a two character string. The 

first character is used as a history 
character in place of ' ' I ' ', the second 
character is used in place of the 
substitution mechanism. For example, ''set 
histchars=", 7 "'' will cause the history 
characters to be comma and semicolon. 

history Can be given a numeric value to control the 

size of the history list. Any command which 
has been referenced in this many events will 
not be discarded. Too large values of 
history may run the shell out of memory. The 
last executed command is always saved on the 
history list. 

home The home directory of the invoker, 

initialized from the environment. The 
filename expansion of refers to this 
variable. 

ignoreeof If set the shell ignores end-of-file from 

input devices which are terminals. This 
prevents shells from accidentally being 
killed by control-D's. 

mall The files where the shell checks for mail. 

This is done after each command completion 
which will result in a prompt, if a specified 
interval has elapsed. The shell says 'You 
have new mail.' if the file exists with an 
access time not greater than its modify time. 

If the first word of the value of mail is 
numeric it specifies a different mail 
checking interval, in seconds, than the 
default, which is 10 minutes. 

If multiple mail files are specified, then 
the shell says 'New mail in name* when there 
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noclobber 


noglob 


nonomatch 


path 


prompt 


shell 


is mail in the file name » 

A.S described in the section on Input / output ^ 
restrictions are placed on output redirection 
to insure that files are not accidentally 
destroyed, and that '>>‘ redirections refer 
to existing files. 

If set, filename expansion is inhibited. 

This is most useful in shell scripts which 
are not dealing with filenames, or after a 
list of filenames has been obtained and 
further expansions are not desirable. 

If set, it is not an error for a filename 
expansion to not match any existing files; 
rather the primitive pattern is returned. It 
is still an error for the primitive pattern 
to be malformed, i.e. 'echo [' still gives 
an error. 

Each word of the path variable specifies a 
directory in which commands are to be sought 
for execution. A null word specifies the 
current directory. If there is no path 
variable then only full path names will 
execute. The usual search path is 
'/bin' and '/usr/bin', but this may vary from 
system to system. For the super-user the 
default search path is '/etc', '/bin' and 
'/usr/bin'. A shell which is given neither 
the -c nor the -t option will normally hash 
the contents of the directories in the path 
variable after reading . cshrc , and each time 
the path variable is reset. If new commands 
are added to these directories while the 
shell is active, it may be necessary to give 
the rehash or the commands may not be found. 

The string which is printed before each 
command is read from an interactive terminal 
input. If a 'i' appears in the string it 
will be replaced by the current event number 
unless a preceding '\' is given. Default is 
'% ', or '# ' for the super-user. 

The file in which the shell resides. This is 
used in forking shells to interpret files 
which have execute bits set, but which are 
not executable by the system. (See the 
description of Non-builtin Command Execution 
below.) Initialized to the (system-dependent) 
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home of the shell. 

status The status returned by the last command. If 

it terminated abnormally, then 0200 is added 
to the status. Builtin commands which fail 
return exit status '1', all other builtin 
commands set status '0'. 

time Controls automatic timing of commands. If 

set, then any command which takes more than 
this many cpu seconds will cause a line 
giving user, system, and real times and a 
utilization percentage v/hich is the ratio of 
user plus system times to real time to be 
printed when it terminalies. 

verbose Set by the -v command line option, causes the 

words of each coromand to be printed after 
history substitution. 

Non-builtin command execution 

When a command to be executed is found to not be a builtin 
command the shell attempts to execute t;he command via 
exec (2). Each word in the variable ^ajih names a directory 
from which the shell will attempt to execute the command. 

If it is given neither a -c nor a -t option, the shell will 
hash the names in these directories into an internal table 
so that it will only try an exec in a directory if there is 
a possibility that the command resides there. This greatly 
speeds command location when a large number of directories 
are present in the search path. If thi.s mechanism has been 
turned off (via unhash ), or if the she].l was given a -c or 
-t argument, and in any case for each directory component of 
path which does not begin with a the shell 

concatenates with the given command name to form a path name 
of a file which it then attempts to exescute. 

Parenthesized commands are always execvited in a subshell. 
Thus '(cd ; pwd) ; pwd' prints the honui directory; leaving 
you where you were (printing this after the home directory), 
while 'cd ; pwd' leaves you in the honus directory. 
Parenthesized commands are most often i.rsed to prevent chdir 
from affecting the current shell. 

If the file has execute permissions but. is not an executable 
binary to the system, then it is assuraesd to be a file 
containing shell commands an a nev/ she].l is spawned to read 
it. 

If there is an alias for shell then thes words of the alias 
will be prepended to the argument list to form the shell 
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command. The first word of the alias should be the full 
path name of the shell (e.g. '$shell'). Note that this is a 
special, late occurring, case of alias substitution, and 
only allows words to be prepended to the argument list 
without modification. 

Argument list processing 

If argument 0 to the shell is then this is a login 
shell. The flag arguments are interpreted as follows; 

-c Commands are read from the (single) following argument 
which must be present. Any remaining arguments are 
placed in argv . 

-e The shell exits if any invoked command terminates 
abnormally or yields a non-zero exit status. 

-f The shell will start faster, because it will neither 

search for nor execute commands from the file '.cshrc' 
in the invokers home directory. 

-i- The shell is interactive and prompts for its top-level 
input, even if it appears to not be a terminal. Shells 
are interactive without this option if their inputs and 
outputs are terminals. 

-n Commands are parsed, but not executed. This may aid in 
syntactic checking of shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A '\' may 

be. used to escape the newline at the end of this line 
and continue onto another line. 

-V Causes the verbose variable to be set, with the effect 
that command input is echoed after history 
substitution. 

-X Causes the echo variable to be set, so that commands 
are echoed immediately before execution. 

-V Causes the verbose variable to be set even before 
'.cshrc' is executed. 

-X Is to -X as -V is to -v. 

After processing of flag arguments if arguments remain but 
none of the -c, -i, -s, or -t options was given the first 
argument is taken as the name of a file of commands to be 
executed. The shell opens this file, and saves its name for 
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possible resubstitution by '$0*. Since mari 
either the standard version 6 or version 7 
shell scripts are not compatible with this 
will execute such a 'standard' shell if th^ 
of a script is not a i.e. if the scrip 

with a comment. Remaining arguments initi4 
argv. 


Signal handling 


The shell normally ignores quit signals 
quit signals are ignored for an invoked co; 
command is followed by otherwise the 

values which the shell inherited from its 
shells handling of interrupts can be contrd 
Login shells catch the terminate signal; ot. 
signal is passed on to children from the st. 
shell's parent. In no case are interrupts 
login shell is reading the file '.logout*. 

AUTHOR 

William Joy 


Th 


mmi 


FILES 


~/.cshrc 
~/.login 
“/.logout 
/bin/ sh 
/tmp/sh* 

/dev/null 
/etc/passwd 


Read at beginning of execu 
Read by login shell, after 
Read by login shell, at Icj' 
Standard shell, for shell 
Temporary file for '<<'. 
Source of empty file. 
Source of home directories 


LIMITATIONS 

Words can be no longer than 512 characters, 
-characters in an argument varies from systej 
Early version 6 systems typically have 512 
while later version 6 and version 7 system^ 
character limits- The number of arguments 
which involves filename expansion is limits 
number of characters allowed in an argument 
command substitutions may substitute no mor 
are allowed in an argument list. 

To detect looping, the shell restricts the 
substitutions on a single line to 20 . 

SEE ALSO 

access{2), exec(2), fork(2), pipe(2), signa} 
wait(2), a.out(5), environ(5), 'An introduq 
shell' 


CSH(l) 


y systems use 
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first character 
t does not start 
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e interrupt and 
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for '~name' 
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m to system, 
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list. Also 
e characters than 


number of alias 
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BUGS 
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Control structure should be parsed rather than being 
recognized as built-in connnands. This would allow control 
commands to be placed anywhere, to be combined with 'I', and 
to be used with and metasyntax. 

Commands within loops, prompted for by '?', are not placed 
in the history list. 

It should be possible to use the modifiers on the output 
of command substitutions. All and more than one 
modifier should be allowed on substitutions. 

Some commands should not touch status or it may be so 
transient as to be almost useless. Oring in 0200 to status 
on abnormal termination is a kludge. 

In order to be able to recover from failing exec commands on 
version 6 systems, the new command inherits several open 
files other than the normal standard input and output and 
diagnostic output. If the input and output are redirected 
and the new command does not close these files, some files 
may be held open unnecessarily. 

There are a number of bugs associated with the 
importing/exporting of^the PATH. For example, directories 
in the path using the ~ syntax are not expanded in the PATH. 
Unusual paths, such as (), can cause csh to core dump. 

This version of csh does not support or use the process 
control features of the 4th Berkeley Distribution. It 
contains a number of known bugs which have been fixed in the 
process control version. This version is not supported. 
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NAME 

cut - cut out selected fields of each li.ne of a file 

SYNOPSIS 

cut -clist [filel file2 ...] 

cut -flist C-dchar] C-s] [filel file2 

DESCRIPTION 

Use cut to cut out columns from a table or fields from each 
line of a file; in data base parlance, i.t implements the 
projection of a relation. The fields as specified by list 
can be fixed length, i.e., character positions as on a 
punched card (-c option), or the length can vary from line 
to line and be marked with a field delimiter character like 
tab (-f option) . Cut can be used as a Jrilter; if no files 
are given, the standard input is used. 

The meanings of the options are: 

list A comma-separated list of integer field numbers (in 
increasing order), with optioncil - to indicate 
ranges as in the -o option of nroff / troff for page 
ranges; e.g., 1,4,7; 1-3,8; -S'] 10 (short for 
1-5,10); or 3- (short for third through last 
field). 

-c list The list following -c (no space) specifies 

character positions (e.g., -cl-72 would pass the 
first 72 characters of each line). 

- flist The list following -f is a list of fields assumed 
to be separated in the file by a delimiter 
character (see -d ); e.g. , -f].,7 copies the first 
and seventh field only. Lines with no field 
delimiters will be passed through intact (useful 
for table subheadings), unless -s is specified. 

- dchar The character following -d is the field delimiter 
(-f option only). Default is tab . Space or other 
characters with special meaning to the shell must 
be quoted. ' 

-s Suppresses lines with no delimiter characters in 

case of -f option. Unless specified, lines with no 
delimiters will be passed through untouched. 

Either the -c or -f option must be specified. 

HINTS 

Use grep (1) to make horizontal ''cuts'' (by context) through 
a file, or paste d) to put files together column-wise (i.e., 
horizontally) . ^To reorder columns in a table, use cut and 
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paste . 

EX2^MPLES 

cut -d; -fl,5 /etc/passwd 

mapping of user IDs to names 

name='who am i 1 cut -fl -d" 

to set name to current login name. 

D]^GNOSTICS 

line too long 

A line can have no more than 511 characters or 
fields. 

bad l ist for c/^ option 

Missing -c or -f option or incorrectly specified 
list . No error occurs if a line has fewer 
fields than the list calls for. 

no fields The list is empty. 

SEE ALSO 

grep(l), pasted). 
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NAME 

date - print and set the date 
SYNOPSIS 

date C yymmddhhimn [ .ss ] ] 


DESCRIPTION 

If no argument is given, the current da 
printed. If an argument is given, the 
yy is the last two digits of the year; 
month number; ^ is the day number in t 
hour number (24 hour system); the secon 
number; .s£ is optional and is the seco 

date 10080045 

sets the date to Oct 8, 12{45 AM. The 
may be omitted, the current values bein 
system operates in GMT. Date takes car 
to and from local standard and daylight 


ke and time are 
current date is set. 
the first nun is the 
lie month; hh is the 
d nm is the minute 
ids. For example: 


year, month and day 
g the defaults. The 
e of the conversion 
time. 


FILES 

/usr/adm/wtmp to record time-setting 


SEE ALSO 

utmp(5) 


DIAGNOSTICS 

'No permission’ if you aren't the super-user and you try to 
change the date; 'bad conversion' if the date set is 
syntactically incorrect. 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc C file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily 
it operates on decimal integers, but one may specify an 
input base, output base, and a number of fractional digits 
to be maintained. The overall structure of ^ is a stacking' 
(reverse Polish) calculator. If an argument is given, input 
is taken from that file until its end, then from the 
standard input. The following constructions are recognized; 

numbe r 

The value of the number is pushed on the stack. A 
number is an unbroken string of the digits 0-9. It 
may be preceded by an underscore _ to input a negative 
number. Numbers may contain decimal points. 

+ -/*%" 

The top two values on the stack are added (+), 
subtracted (-), multiplied (*), divided (/), 
remaindered (%), or exponentiated (*'). The two 
entries are popped off the stack; the result is pushed 
on the stack in their place. Any fractional part of 
an exponent is ignored. 

SJC The top of the stack is popped and stored into a 

register named x, where x may be any character. If 
the s is capitalized, is treated as a stack and the 
value is pushed on it. 

lx The value in register x is pushed on the stack. The 
register x is not altered. All registers start with 
zero value. If the 1 is capitalized, register x is 
treated as a stack and its top value is popped onto 
the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value 

remains unchanged. P interprets the top of the stack 
as an ascii string, removes it, and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the 
recursion level is popped by two. If q is 
capitalized, the top value on the stack is popped and 
the string execution level is popped by that value. 
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X treats the top element of the stack as a character . 
string and executes it as a string of dc commands. 

X replaces the number on the top of the stack with its 
scale factor. 

C ... 3 

puts the bracketed ascii string opto the top of the 
stack. 

<x >x =x 

The top two elements of the stack are popped and 
compared. Register x is executed if they obey the 
stated relation. 

V replaces the top element on the stack by its square 

root. Any existing fractional part of the argument is 
taken into account, but otherwise the scale factor is 
ignored. 

1 interprets the rest of the line as a UNIX command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the 

number radix for further input. I pushes the input 
base on the top of the stack. 

o The top value on the stack is popped and used as the 

number radix for further output. 

0 pushes the output base on the top of the stack. 


z 

Z 


the top of the stack is popped, ajnd that value is used 
as a non-negative scale factor: the appropriate number 


of places are printed on output, and maintained during 
multiplication, division, and exponentiation. The 
interaction of scale factor, input base, and output 
base will be reasonable if all are changed together. 

The stack level is pushed onto the stack. 

replaces the number on the top of the stack with its 
length. 


? A line of input is taken from the input source 

(usually the terminal) and executed. 

7 : are used by be for array operations. 

An example which prints the first ten values of nl is 
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Clal+dsa*plal0>y]sy 

0sal 

lyx 


SEE ALSO 

bed), which is a preprocessor for ^ providing infix 
notation and a C-like syntax which implexients functions and 
reasonable control structures for programs. 

DIAGNOSTICS 

'x is unimp1ernented' where x is an octal number. 

'stack empty* for not enough elements on the stack to do 
what was asked. 

'Out of space* when the free list is exhausted (too many 
digits). 

'Out of headers* for too many numbers being kept around. 
'Out of pushdown* for too many items oh the stack. 

'Nesting Depth* for too many levels of nested execution. 
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NAME 


dd - convert and copy a file 


SYNOPSIS 

dd Coption=value3 ... 

DESCRIPTION 

Dd copies the specified input file to t 
^th possible conversions. The standard 
are used by default. The input and out 
specified to take advantage of raw phys 


option 

if= 

of= 

itas=n 

obs=n 

bs=n 


cbs=n 

skip=n 

files=n 

seek=n 

count*n 

conv=ascii 

ebcdic 

ibm 

lease 

ucase 

swab 

noerror 

sync 


values 


input file name? standar 
output file name? stands 
input block size n bytes 
output block size (defau 
set both input and outpi^ 
superseding ibs and obs ? 
conversion is specified, 
efficient since no copy 
conversion buffer size 
skip n input records before starting copy 
copy n files from (tape) ’ 
seek n records from begi 
before copying | 

copy only n input records 
convert EBCDIC to ASCII 
convert ASCII to EBCDIC 

slightly different map of ASCII to EBCDIC 
map alphabetics to lowei: case 
map alphabetics to uppei: case 
swap every pair of bytes 
do not stop processing on an error 
pad every input record ^o ibs 
several comma-separated 


DD(1) 


.he specified output 
d input and output 
put block size may be 
ical l/O. 


d input is default 
rd output is default 
(default 512) 

It 512) 
t block size, 
also, if no 
it is particularly 
need be done 


input 

nning of output file 


Where sizes are specified, a number of 
number may end with k, b or w to speci 
1024, 512, or 2 respectively; a pair o 
separated^by x to indicate a product. 


conversions 

bytes is expected. 
^ multiplication by 
numbers may be 


Cbs is used only if ascii or ebcdic co 
In the former case cbs characters are 
conversion buffer, converted to ASCII, 
trimmed and new—line added before send 
output. In the latter case ASCII char 
the conversion buffer, converted to EB 
to make up an output, record of size cb 


After completion, ^ reports the nuitibe 
input and output blocks. 


nversion is specified, 
placed into the 
and trailing blanks 
Lng the line to the 
acters are read into 
iCDIC, and blanks added 
s. 


t of whole and partial 
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For example, to read an EBCDIC tape blocked ten 80-byte 
EBCDIC card images per record into the ASCII file x: 

dd if“/dev/rmt0 of=x ibs=800 cbs»80 conv^ascii,lease 

Note the use of raw magtape. Dd is especially suited to l/O 
on the raw physical devices because it allows reading and 
writing in arbitrary record sizes. 

To skip over a file before copying from magnetic tape- do 
(dd of=/dev/null; dd of=x) </dev/rmt0 


SEE ALSO 

cp{l), tr(l) 

DIAGNOSTICS 

f+p records in(out): numbers of full and partial records 
read(written) 


BUGS 

The AoCII/ebcDIC conversion tables are taken from the 256 
character standard in the CACM Nov, 1968. The 'ibm' 
conversion, while less blessed as a standard, corresponds 
better to certain IBM print train conventions. There is no 
universal solution. 

Newlines are inserted only on conversion to ASCII; padding 
is done only on conversion to EBCDIC. These should be 
separate options. 
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NAME 

delta - make a delta (change) to an SCCS file 
SYNOPSIS 

delta C-rSID] C-s] C-n] C-glist] C-mCmrlist]] C-yCcomment]] 
C-p] files 

DESCRIPTION 

Delta is used to permanently introduce into the named SCCS 
file changes that v/ere made to the file retrieved by get (l) 
(called the g- file , or generated file). 

Delta makes a delta to each named SCCS file. If a directory 
is named, delta behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files 
(last component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of - is 
given, the standard input is read (see WARNINGS )7 each line 
of the standard input is taken to be the name of an SCCS 
file to be processed. 

Delta may issue prompts on the standard output depending 
upon certain keyletters specified and f’lags (see admin ( 1 )) 
that may be present in the SCCS file (see -m and -y 
keyletters below). 

Keyletter arguments apply independently’ to each named file. 

-r SID Uniquely identifies; which delta is to be 

made to the SCCS fi.le. The use of this 
keyletter is necessiary only if two or 
more outstanding Sfsts for editing (get 
-e) on the same SCCS file were done by 
the same person (login name). The SID 
value specified with the -r keyletter 
can be either the SiID specified on the 
get command line or the SID to be made 
as reported by the get command (see 
get (1)). A diagnositic results if the 
specified SID is anibiguous, or, if 
necessary and omitt;ed on the command 
line. 

-s Suppresses the issue, on the standard 

output, of the crecited delta's SID, as 
well as the number of lines inserted, 
deleted and unchanged in the SCCS file. 

-n Specifies retention of the edited g- file 

(normally removed a.t completion of delta 
processing). 
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- qlist Specifies a list (see get (l) for the 

definition of list ) of deltas which are 
to be ignored when the file is accessed 
at the change level (SID) created by 
this delta. 

-mC mrlist !) If the SCCS file has the v flag set (see 

admin d)) then a Modification Request 
(MR) number must be supplied as the 
reason for creating the new delta. 

If -m is not used and the standard input 
is a terminal, the prompt MRs? is issued 
on the standard output before the 
standard input is read; if the standard 
input is not a terminal, no prompt is 
issued. The MRs? prompt always precedes 
the comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks 
and/or tab characters. An unescaped 
new-line character terminates the MR 
list. 


Note that if the v flag has a value (see 
admin d)), it is taken to be the name of 
a program (or shell procedure) which 
will validate the correctness of the MR 
numbers. If a non-zero exit status is 
returned from MR number validation 
program, delta terminates (it is assumed 
that the MR numbers were not all valid). 

-yC comment ] Arbitrary text used to describe the 
reason for making the delta. A null 
string is considered a valid comment . 

If -y is not specified and the standard 
input is a terminal, the prompt 
comments? is issued on the standard 
output before the standard input is 
read; if the standard input is not a 
terminal, no prompt is issued. An 
unescaped new-line character terminates 
the comment text. 

-p - Causes delta to print (on the standard 

output) the SCCS file differences before 
and after.the delta is applied in a 
diff (1) format. 

FILES 
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All files of the form ?-file are explained in the Source 
Code Control System User 's Guide . The naming convention for 
these files is also described there. 

g-file Existed before the exiscution of delta ; 

removed after completion of delta . 

P“file Existed before the execution of delta ; may 

exist after completion of delta , 
q-file Created during the execution of delta ; 

removed after completion of delta , 
x-file Created during the execution of delta ; 

renamed to SCCS file after completion of 
delta . 

z-file Created during the execution of delta ; 

removed during the execution of delta . 
d-file Created during the execution of delta ; 

removed after completion of delta . 
/usr/bin/bdiff Program to compute differences between the 

''gotten'' file and the g- file . 

WARNINGS 

Lines beginning with an SOH ASCII character (binary 001) 
cannot be placed in the SCCS file unless the SOH is escaped. 
This character has special meaning to SCCS (see 3ccsfile (5)) 
and will cause an error. 

A get of many SCCS files, followed by a delta of those 
files, should be avoided when the get generates a large 
amount of data. Instead, multiple get / delta sequences 
should be used. 

If the standard input (-) is specified on the delta command 
line, the -ra (if necessary) and -y keyletters must also be 
present. Omission of these keyletters causes an error to 
occur. 

SEE ALSO 

admin(l), bdiff(i), get(l), help(l), prs(l), sccsfile(5). 
Source Code ’ Control System User * s Guid e by L. E. Bonanni and 
C. A. Salemi. 

DIAGNOSTICS 

Use help (1) for explanations. 
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NAME 

df - disk free 
SYNOPSIS 

df C -i ] [ “1 ] C filesystem ... ] [ file ... 3 
DESCRIPTION 

Df prints out the amount of free disk space available on the 
specified filesystem , e.g. ''/dev/dk0a'', or on the 
filesystem in which the specified file , e.g. "$HOME'', is 
contained. If no file system is specified, the free space 
on all of the normally mounted file systems is printed. The 
reported numbers are in kilobytes. 

other options are: 

-i Report also the number of inodes which are used and 
free. 

-1 examines also the free list, double checking that the 

summary number in the filesystem superblock is correct. 

FILES 

/etc/fstab list of normally mounted filesystems 
SEE ALSO 

fstab(5), icheck(8), quot(3) 
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NAME 


diff - differential file and directory comparator 


SYNOPSIS 

diff C -1 ] C -r ] C -8 ] C -cefh ] C -b ] dirl dir2 
diff C -cefh 3 C -b ] filel file2 
diff C -D string ] [ -b 3 filel file2 


DESCRIPTION 

If both arguments are directories, diff 


of the directories by name, and then ru 
diff algorithm (described below) on tex 
different. Binary files which differ, 
subdirectories, and files which appear 
are listed. Options when comparing dir 


DIPP(1) 


-1 


sorts the contents 
ris the regular file 
files which are| 
Common 

in only one directory 
^ctories are: 

diff is piped 


long output format; each text file — 

through £rU) to paginate it, other differences are 
remembered and summarized after all text file 
differences are reported. 


-r 


-s 


causes application of diff recursi 
subdirectories encountered. 

causes diff to report files which 
are otherwise not mentioned. 


yely to common 


are the same, whi 


-Snarae 

starts a directory diff in the mid| 
file name. 


die beginning wit 


When run on regular files, and when com 
which differ during directory comparisoj 
lines must be changed in the files to o 
agreement. Except in rare circumstance 
smallest sufficient set of file differe 
filel nor file2 is a directory, then ei 
in which case the standard input i 
a directory, then a file in that direct 
is the same as the file-name of file2 
versa) . 


bh 


jparing text files 
n, diff tells wha 
ring them into 
s, diff finds a 

If neither 


nces. 
ther may be given] 
s used. If filel 


ory whose file-na 
s used (and vice 


h 


as 

is 

me 


There are several options for output fojrraat; the default] 
output format contains lines of these ^orms; 

nl a n3, n4 
n^, d n^ 

n3^, c n3, n4 

These lines resemble ^ commands to conlvert filel into 
file2. The numbers after the letters pjertain to file2 . 
fi^t, by exchanging 'a' for 'd' and reading backward on^ 
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ascertain equally how to convert file2 into filel . As in 
ed » identical pairs where ^ or n3 = ^ are abbreviated 

as a single nuiriber. 

Following each of these lines come all the lines that are 
affected in the first file flagged by '<*, then all the 
lines that are affected in the second file flagged by *>'. 

Except for -b, which may be given with any of the others, 
the following options are mutually exclusive: 

-e producing a script of a, c and d commands for the 

editor which will recreate file2 from filel . 

In connection with -e, the following shell program 
may help maintain multiple versions of a file. 

Only an ancestral file ($1) and a chain of 
version-to-version ed scripts ($2,$3,...) made by 
diff need be on hand. A 'latest version* appears 
on the standard output. 

(shift; cat $*; echo 'l,$p‘) 1 ed - $1 

Extra commands are added to the output when 
comparing directories with -e, so that the result 
is a ^(1) script for converting text files which 
are common to the two directories from their state 
in dirl to their state in dir2 . 

-f produces a script similar to that of -e, not useful 

with and in the opposite order. 

"C produces a diff with lines of context. The default 

is to present 3 lines of context and may be 
changed, e.g to 10, by -cl0. With -c the output 
format is modified slightly; the output beginning 
with identification of the files involved and their 
creation dates and then each change is separated by 
a line with a dozen *'s. The lines removed from 
filel are marked with those added to file2 are 

marked '+'. Lines which are changed from one file 
to the other are marked in both files with '1’. 

“h does a fast, half-hearted job. It works only when 

changed stretches are short and well separated, but 
does work on files of unlimited length. 

-Datring causes diff to create a merged version of filel and 
file2 on the standard output, with C preprocessor 
controls included so that a compilation of the 
result without defining string is equivalent to 
compiling filel, while defining string will yield 
file2. 


Page 2 


(printed 8/22/83) 



DIFF(l) 


-b 


Nu Machine UNIX Programmer'e 


Manual 


DIE^(l) 


causes trailing blanks (spaces, 
ignored, and other strings of 
equal. 


and tabs) to be 
blanks to coroparel 


FILES 


/tmp/d????? 

/usr/lib/diffh for -h 
/usr/bin/pr 

SEE ALSO 

cmp(l), cc(l), coram(l), ed(l) 
DIAGNOSTICS 

Exit status is 3 for no differences, 1 
trouble. 


BUGS 


Editing scripts produced under the -e o 
about creating lines consisting of a single 


for some, 2 for 


r -f option are n. 


aive 


When comparing directories with the -b option specified, 
diff first compares the files ala cmp , and then decides 
run the diff algorithm if they are not jequal. This may 
cause a small amount of spurious output 

turn out to be identical because the onjly differences arjs 
insignificant blank string differences. 


to 
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NAME 

diff3 - 3-way differential file comparison 
SYNOPSIS 

diff3 C -ex3 ] filel file2 file! 
DESCRIPTION 


Diff3 compares three versions of a file, and publishes 
disagreeing ranges of text flagged with these codes: 

===== all three files differ 

filel is different 

====2 file2 is different 

====3 file3 is different 

The type of change suffered in converting a given range of a 
given file to some other is indicated in one of these ways: 


f : n]^ a Text is to be appended after line number nl 

in file f, where f = 1, 2, or 3. 

f : rU , n2 c Text is to be changed in the range line ^ 

to line n2. If nl^ » n2, the range may be 
abbreviated to nl . 

The original contents of the range follows immediately after 
a c indication. VThen the contents of two files are 
identical, the contents of the lower-numbered file is 
suppressed. 

Under the -e option, diff3 publishes a script for the editor 
ed that will incorporate into filel all changes between 
file2 and file3 , i.e. the changes that normally would be 
flagged ==== and =====3. Option -x (-3) produces a script to 
incorporate only changes flagged “== (=*== 3 ). The 
following command will apply the resulting script to 
'filel*. 


(cat script; echo 'l,$p') ! ed - filel 

FILES 

/tmp/d3????? 

/usr/lib/diff3 

SEE ALSO 

diffd) 


BUGS 

Text lines that consist of a single '.' will defeat -e. 
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NAME 


du - summarize disk usage 


SYNOPSIS 

du C -s ] C -a 3 C name 


3 


DESCRIPTION 

Du gives the number of blocks contained! 


Trecursively) directories within each specified director 
file name . If name is missing, ' 


IS 


Manual 


PU(I) 


in all files and 


used. 


y or 


The optional argument -s causes only the grand total to pe 
given. The optional argument -a causes an entry to be 
generated for each file. Absence of either causes an enjtry 
to be generated for each directory only. 

A file which has two links to it is only counted once. 


BUGS 


Non-directories given as arguments (not 
not listed. 

If there are too many distinct linked fjiles, du counts t%& 
excess files multiply. 


under -a option) 


are 
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NAME 

dump - incremental file system dump 
SYNOPSIS 

dump C key C argument ... ] filesystem ] 

DESCRIPTION 

Dump copies to magnetic tape all files changed after a 
certain date in the filesystem . The key specifies the date 
and other optdons about the dump. Key consists of 
characters from the set 0123456789fusd. 

f Place the dump on the next argument file instead of the 
tape. 

u If the dump completes successfully, write the date of 
the beginning of the dump on file '/etc/ddate'. This 
file records a separate date for each filesystem and 
each dump level. 

0-9 This number is the 'dump level'. All files modified 

since the last date stored in the file '/etc/ddate' for 
the same filesystem at lesser levels will be dumped. 

If no date is determined by the level, the beginning of 
time is assumed; thus the option 0 causes the entire 
filesysteia to be dumped. 

s The size of the dump tape is specified in feet. The 
number of feet is taken from the next argument. When 
the specified size is reached, the dump will wait for 
reels to be changed. The default size is 2300 feet. 

d The density of the tape, expressed in DPI, is taken 

from the next argument . This is used in calculating the 
amount of tape used per write. The default is 1600. 

If no arguments are given, the key is assumed to be 9u and a 
default file system is dumped to the default tape. 

Now a short suggestion on how perform dumps. Start with a 
full level 0 dump 

dump 0u 

Next, periodic level 9 dumps should be made on an 
exponential progression of tapes. (Sometimes called Tower 
of Hanoi -12131214... tape 1 used every other 
time, tape 2 used every fourth, tape 3 used every eighth, 
etc.) 


dump 9u 
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When the level 9 incremental approaches 
78000 blocks at 1600 BPI blocked 20), a 
be made. 

dump lu 

After thiS/ the exponential series shoulj 
uninterrupted. These level 9 dumps are 
dump which is based on the level 0 full 
progression of levels of dump can be ca^ 
desired. 


d progress as 
based on the levejl 1 
dump. This 
ried as far as 


•PILES 


default filesystem and tape vary with ir^ 
/etc/ddate: record dump dates of filesy 

SEE ALSO 

restor(l), dump(5), dumpdir(l) 


stallation. 
sitem/level. 


DIAGNOSTICS 

If the dump requires more than one tape, 
change tapes. Reply with a new-line wh^ 
done. 


BUGS 


Sizes are based on 1600 BPI blocked tapej 
device has to be used to approach these 
errors on the filesystem are ignored. Wf 
magtape are usually fatal. 
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level 1 dump should 


it will ask you 
n this has been 


The raw raagtap] 
densities. Read 
rite errors on thl 
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NAME 

echo - echo arguments 
SYNOPSIS 

echo [ -n ] C arg ] ... 


DESCRIPTION 

Echo writes its arguments separated by blanks and terminated 
by a newline on the standard output. If the flag -n is 
used, no newline is added to the output. 

Echo is useful for producing diagnostics in shell programs 
and for writing constant data on pipes. To send diagnostics 
to the standard error file, do 'echo ... 1>&2*. 
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NAME 


ed - text editor 


SYNOPSIS 

ed C - ] C -X ] C name 3 
DESCRIPTION 

Ed is the standard text editor. 


Manual 


ED(1) 


If a name argument is given, ed simulates an e c 
below) on the named file; that is to say, the fi 


command ( 

- - _ _ file is re 

into buffer so that it can be edited. If -x is 

present, an x command is simulated first to handle an 
encrypted file. The optional - suppresses the printing 
character counts by e, r, and w commands 


Ed operates on a copy of any file it is 
made in the copy have no effect on the” 
(write) command is given. The copy of 


resides in a temporary file called the buffer . 


editing; changes 
file until a w 
the text being ed 


r structure: zerol or 
racter command , 
command. These 
the buffer. Missling 


Coramands to ^ have a simple and regula 
more addresses followed by a single cha[ 
possibly followed by pareuneters to the 
addresses specify one or more lines in 
addresses are supplied by default. 

In general, only one command may appear] 
commands allow the addition of text to 
is accepting text, it is said to be in 
mode, no commands are recognized; all 
collected. Input mode is left by typin] 
at the beginning of a line. 

Ed supports a limited form of regular e xpression notatio 
A reaular a o-F e4*f-’Sn^a rs-P 


* 4 , _ _ _ _ - -- J ^ 

A regular expression specifies a set ofj strings of 
characters. A member of this set of strings is said to 
matched by the regular expression. In ^he following 
specification for regular expressions the word 'characte 
means any character but newline 


see 

ad 


of 


ited 


on a line. Cert 
the buffer. Whil 
input mode . In th 


nput is merely 
g a period '.' al 


am 
e ed 
is 

cne 


1 . 


2 . 


3. 


4. 


Any character except a special chap 
itself. Special characters are th 
delimiter plus \C. and sometimes 


acter matches 
je regular express 
*$. 


matches any character 


A \ followed by any character except a digit or () 
matches that character. 


A nonempty string £ bracketed C^] 
character in (or not in) s. In s. 
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meaning, and ] may only appear as the first letter. A 
substring a-b, with a and b in ascending ASCII order, 
stands for the inclusive range of ASCII characters. 

5. A regular expression of form 1-4 followed by * matches 
a sequence of 0 or more matches of the regular 
expression. 

6. A regular expression, x, of form 1-8, bracketed \(x\) 
matches what x matches. 

7. A \ followed by a digit n matches a copy of the string 
that the bracketed regular expression beginning with 
the nth \( matched. 

8. A regular expression of form 1-8, x, followed by a 
regular expression of form 1-7, y matches a match for x 
followed by a match for y, with the x match being as 
long as possible while still permitting a y match. 

9. A regular expression of form 1-8 preceded by “ (or 
followed by $), is constrained to matches that begin at 
the left (or end at the right) end of a line. 

10. A regular expression of form 1-9 picks out the longest 
among the leftmost matches in a line. 

11. An empty regular expression stands for a copy of the 
last regular expression encountered. 

Regular expressions are used in addresses to specify lines 
and in one command (see ^ below) to specify a portion of a 
line which is to be replaced. If it is desired to use one 
of the regular expression metacharacters as an ordinary 
character, that character may be preceded by '\'. This also 
applies to the character bounding the regular expression 
(often '/') and to '\' itself. 

To understand addressing in ^ it is necessary to know that 
at any time there is a current line . Generally speaking, the 
current line is the last line affected by a command; 
however, the exact effect on the current line is discussed 
under the description of the command. Addresses are 
constructed as follows. 

1. The character addresses the current line. 

2. The character addresses the last line of the 

buffer. 

3. A decimal number n addresses the n-th line of the 
buffer. 
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4. 


5. 


' 'jc* addresses the line marked wit 
must be a lower-case letter. Line 
k command described below. 


the name x, which 
is are marked with the 


si 


A regular expression enclosed in 
the line found by searching forwar! 
line and stopping at the first lin|e 
that matches the regular expressio 
search wraps around to the beginnihg of the buffer. 


ashes '/' addresk 
il from the currenit 
containing a 
If necessary 


6 . 


A regular expression enclosed in q 
the line found by searching backwair 
line and stopping at the first lin^ 
that matches the regular expressio 
search wraps around to the end of 


7. 


An address followed by a plus sign 
followed by a decimal number s 
plus (resp. minus) the indicated n 
plus sign may be omitted. 


8. If an address begins with '+' or ’ 
subtraction is taken with respect 
e.g, '-5' is understood to mean 


Epd) 


stir 


ing 

the 


iieries '?' addresk 
d from the curre 
containing a stt 
n. If necessary 
the buffer. 


es 

ht 

ing 

the 


'+' or a minus s 
becifies that addt 
umber of lines. 


the addition or 
to the current liijie; 


then 1 is added 


9. If an address ends with '+' or 

(resp. subtracted). As a consequehce of this rule ind 
rule 8, the address refers to |the line before the 

current line. Moreover, trailing r+* and 
characters have cumulative effect, so '—' refers tb 
the current line less 2. 

10. To maintain compatibility with earlier versions of 4he 
editor, the character in addresses is equivalent to 


es 


fgn 

ess 

The 


Commands may require zero, one, or two 
which require no addresses regard the pt 
as an error. Commands which accept one 
assume default addresses when insufficib 
more addresses are given than such a co 
last one or two (depending on what is a 


Addresses. Commands 
esence of an addijress 
or two addresses 
nt are given. If 

t mand requires, tlji 
cetJted) are used 


to 


Addresses are separated from each other 
They may also be separated by a s 
this case the current line '.' is set 
address before the next address is inteb 
feature can be used to determine the sta 
forward and backward searches ('/', 
address of any two-address sequence musl^ 
line following the line corresponding 


to 


typically by a cqmma 
kmicolon ';'. In 
the previous 
preted. This 
rting line for 
The second 
correspond to a 
the first addreks 
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In the following list of ^ commands/ the default addresses 
are shown in parentheses. The parentheses are not part of 
the address/ but are used to show that the given addresses 
are the default. 

As mentioned/ it is generally illegal for more than one 
command to appear on a line. However/ most commands may be 
suffixed by 'p* or by 'l'/ in which case the current line is 
either printed or listed respectively in the way discussed 
below. 

(. )a 
<text> 

• 

The append coraraand reads the given text and appends it 
after the addressed line. is left on the last line 

input, if there were any, otherwise at the addressed 
line. Address *0* is legal for this command; text is 
placed at the beginning of the buffer. 

(. / . )c 
<text> 

The change command deletes the addressed lines, then 
accepts input text which replaces these lines. is 

left at the last line input; if there were none, it is 
left at the line preceding the deleted lines. 

(./ . )d 

The delete cojnmand deletes the addressed lines from the 
buffer. The line originally after the last line 
deleted becomes the current line; if the lines deleted 
were originally at the end, the new last line becomes 
the current line. 

e filename 

The edit command causes the entire contents of the 
buffer to be deleted, and then the named file to be 
read in. '.' is set to the last line of the buffer. 

The number of characters read is typed. 'filename' is 
remembered for possible use as a default file name in a 
subsequent r or w command. If 'filename' is missing, 
the remembered name is used. 

E fiLename 

This command is the same as e, except that no 
diagnostic results when no w has been given since the 
last buffer alteration. 

f filename 

The filename command prints the currently remembered 
file name. If 'filename' is given, the currently 
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remembered file name is changed to 'filename*. 


(1»?)g/regular expression/command list 

In the global command, the first step is to mark « 
line which matches the given regular expression, 
for every such line, the given command list is ext 
with initially set to that line. A single cor 

or the first of multiple command;^ appears on the £ 
line with the global command. A].l lines of a mull 
line list except the last line must be ended with 
A, i^, and c commands and associat:ed input are 
permitted; the '. ' terminating input mode raay be 
omitted if it would be on the lasit line of the cor 
list. The comraands £ and v are not permitted in i 
coramand list. 

(.)i 

<text> 


ivery 

Then 

icuted 

imand 

ame 

•i- 


imand 

•he 


This command inserts the given text before the 
addressed line. is left at the last line input, 

or, if there were none, at the li.ne before the 
addressed line. This coramand diirfers from the a 
command only in the placement of the text. 

(., .+l)j 

This command joins the addressed lines into a single 
line; intermediate newlines sirapj.y disappear. is 

left at the resulting line. 


The mark coramand marks the addresssed line with name x, 
which must be a lower-case lettei:. The address form 
''jc* then addresses this line. 

(., .)1 

The list coramand prints the addresssed lines in an 
unambiguous way: non-graphic chai’acters are printed in 
two-digit octal, and long lines eire folded. The I 
command may be placed on the samei line after any ron- 
i/o coraraand. 

(., .)ma 

The move command repositions the addressed lines after 
the line addressed by a. The lasit of the moved lines 
becomes the current line. 

(»/ .) P 

The print coraraand prints the addi'essed lines. is 

left at the last line printed. The £ command may be 
placed on the same line after any non-i/o command. 
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(., .)P 

This Goramand is a synonym for £. 

q The quit command causes ^ to exit. No automatic write 
of a file is done. 

Q This command is the same as £, except that no 

diagnostic results when no w has been given since the 
last buffer alteration. 

($)r filename 

The read command reads in the given file after the 
addressed line. If no file name is given, the 
remembered file name, if any, is used (see e and f 
commands). The file name is remembered if. there was no 
remembered file name already. Address '0' is legal for 
r and causes the file to be read at the beginning of 
the buffer. If the read is successful, the number of 
characters read is typed. is left at the last line 

read in from the file. 

( ., ♦)s/regular expression/replacement/ or, 

( ., .)s/regular expression/replacement/g 

The substitute command searches each addressed line for 
an occurrence of the specified regular expression. On 
each line in which a match is found, all matched 
strings are replaced by the replacement specified, if 
the global replacement indicator 'g' appears after the 
command. If the global indicator does not appear, only 
the first occurrence of the matched string is replaced. 
It is an error for the substitution to fail on all 
addressed lines. Any character other than space or 
new-line may be used instead of '/' to delimit the 
regular expression and the replacement. is left at 

the last line substituted. 

An ampersand appearing in the replacement is 
replaced by the string matching the regular expression. 
The special meaning of in this context may be 
suppressed by preceding it by The characters *\n‘ 

where n is a digit, are replaced by the text matched by 
the n-th regular subexpression enclosed between '\(' 
and \) ' . Wlien nested, parenthesized subexpressions 
are present, is determined by counting occurrences of 
'\(' starting from the left. 

Lines may be split by substituting new-line characters 
into them. The ne\/-line in the replacement string must 
be escaped by preceding it by '\'. 

(., .) t a 

This command acts just like the m command, except that 
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a copy of the addressed lines is placed after address a 
(which may be 0). is left on the last line of the 

copy. 

(. / . )u 

The undo command restores the preceding contents of the 
current line, which must be the last line in which a 
substitution was made. 

(1» $)v/regular expression/cominand list 

This command is the same as the global command ^ e:ccept 
that the comraand list is executed £ with initially 

set to every line except those matching the regular 
expression. 

(1, $)w filename 

The write command writes the addressed lines onto i:he 
given file. If the file does not exist, it is created 
mode 666 (readable and writable by everyone). The file 
name is remembered if there was n<j remembered file name 
already. If no file name is given, the remembered file 
name, if any, is used (see e and commands). is 

unchanged. If the coramand Ts successful, the number of 
characters written is printed. 

(1,$)W filename 

This command is the same as w, except that the 
addressed lines are appended to the file. 

X key string is demanded from the standard input. 

Later r, e and w commands will encrypt and decrypt the 
text wTth this key by the algorithm of crypt (1). An 
explicitly empty key turns off encryption. 

($)= The line number of the addressed i.ine is typed. '< ' is 
unchanged by this command. 

I<she11 comraand> 

The remainder of the line after the 'I' is sent to 
^(1) to be interipreted as a coranicind. is 

unchanged. 

(.+1)<newline> 

hn address alone on a line causes the addressed lirie to 
be printed. A blank line alone is equivalent to 
'.+lp'; it is useful for stepping through text. 

If an interrupt signal (ASCII OSL) is sent, ^ prints a '?' 
and returns to its command level. 

Some size limitations; 512 characters £)er line, 256 
characters per global command list, 64 characters per file 


I 
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name, and 128K characters in the temporary file. The limit 
on the number of lines depends on the amount of core: each 
line takes 1 word. 

IVhen reading a file, ^ discards ASCII NUL characters and 
all characters after the last newline. It refuses to read 
files containing non-ASCII characters. 


FILES 

/tmp/e* 

ed.hup: work is saved here if terminal hangs up 
SEE ALSO 

B. W. Kernighan, A Tutorial Introduction to the ED Text 
Editor 

B. W. Kernighan, Advanced editing on UNIX 
sed(l), crypt(1) 

DIAGNOSTICS 

'?nane' for inaccessible file; '?' for errors in commands; 
?TMP' for temporary file overflow. 

To protect against throwing away valuable work, a ^ or e 
command is considered to be in error, unless a w has ~ 
occurred since the last buffer change. A second q or e will 
be obeyed regardless. 


BUGS 

The \ command mishandles DEL. 

A I command cannot be subject to a £ command. 

Because 0 is an illegal address for a w command, it is not 
possible to create an empty file with ed. 
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NAME 


edit - text editor (variant of the ex editor for new or 
casual users) 


SYNOPSIS 

edit C -r 3 name ... 

DESCRIPTION 

Edit is a variant of the text editor ex ( 
new or casual users who wish to use .a c 
editor. The following brief introduction 
get started with edit . A more complete 
provided by Edit ; A tutorial . A Ex / editj 
( version ^.0l Ti^ also very useful. 


_ See 

documents; in particular, if you are usi 
you v/ill want to learn about the display 


BRIEF INTRODUCTION 

To edit the contents of an existing file 
command ''edit name*' to the shell. Edi 


the file which you can then edit, and t^ 
lines and characters are in the file, 
just make up a name for the file and tr^^ 
you will cause an error diagnostic, but 


Edit prompts for commands with the character ';', which you 
should see after starting the editor. If you are editing an 
existing file, then you will -have some lines in edit ' s 
buffer (its name for the copy of the file you are editing). 
Most coiamands to edit use its ''current line*' if you don't 
tell them which line to use. Thus if ycu say print (which 
can be abbreviated p) and hit carriage return (as you should 
after all edit commands) this current line will be printed. 
If you delete (d) the current line, edit will print the new 
current line. When you start editing, edit makes the last 
line of the file the current line. If you delete this lalst 


3^) recommended fd 
dmmand oriented 
n should help yoii 
asic introduction is 
command summary 
ex for other useful 
i[ng a CRT terminal] 
editor vi. 


you begin with 
t makes a copy o 
11s you how many 
o create a new fi| 
to run edit on 


don't worry. 


the 


le. 


it; 


If 

line, then the new last line becomes the 
general, after a delete, the next line i 
the current line. (Deleting the last li 
case.) 

If you start with an empty file, or wish 
lines, then the append (a) command can b 
give this command (typing a carriage ret 
append) edit will read lines from your 
give a line consisting of just a 
after the current line. The last line -y| 
the current line. The command insert (i 
places the lines you give before, ratherl 
current line. 

Edit numbers the lines in the buffer, wi 
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having number 1. If you give the command "i** then edit 
will type this first line. If you then give the command 
delete edit will delete the first line, and line 2 will 
become line 1, and edit will print the current line (the new 
line 1) so you can see where you are. In general, the 
current line will always be the last line affected by a 
command. 

You can inaTce a change to some text within the current line 
by using the substitute (s) command. You say ^*s/ old / new /'' 
where old is replaced by the old characters you want to get 
rid of and new is the new characters you want to replace it 
with. 

The command file (f) will tell you how many lines there are 
in the buffer you are editing and will say ''[Modified]'' if 
you have changed it. After modifying a file you can put the 
buffer text back to replace the file by giving a write (w) 
command. You can then leave the editor by issuing a quit 
(q) command. If you run edit on a file, but don't change 
it, it is not necessary (but does no harm) to write the file 
back. If you try to quit from edit after modifying the 
buffer without writing it out, you will be warned that there 
has been ''No write since last change'' and edit will await 
another command. If you wish not to write the buffer out 
then you can issue another quit command. The buffer is then 
irretrievably discarded, and you return to the shell. 

By usiiig the delete and append commands, and giving line 
numbers to see lines in the file you can make any changes 
you desire. You should learn at least a few more things, 
however, if you are to use edit more than a few times. 

The change (c) command will change the current line to a 
sequence of lines you supply (as in append you give lines up 
to a line consisting of only a You can tell change 

to change more than one line by giving the line numbers of 
the lines you want to change, i.e. ''3,Schange''. You can 
print lines this way too. Thus ''l,23p'' prints the first 
23 lines of the file. 

The undo (u) command will reverse the effect of the last 
command you gave which changed the buffer. Thus if give a 
substitute command which doesn't do what you want, you can 
say undo and the old contents of the line will be restored. 
You can also undo an undo command so that you can continue 
to change your mind. Edit will give you a warning message 
when commands you do affect more than one line of the 
buffer. If the amount of change seems unreasonable, you 
should consider doing an undo and looking to see what 
happened. If you decide that the change is ok, then you can 
undo again to get it back. Note that commands such as write 
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and quit cannot be undone. 

To look at the next line in the buffer ^ou can just hit 
carriage return. To look at a number of lines hit *D 
(control key and, while it is held down 
both) rather than carriage return. Thi^ will show you a 
half screen of lines on a CRT or 12 lineis on a hardcopy 
terminal. You can look at the text aro4nd where you are 
giving the command ''z.''. The current 
the last line printed; you can get back 


EDIT 


line will then be 
to the line where 


you were before the ' 'z. ' ' command by sajying The 

command can also be given other following characters ''z- 
prints a screen o£ text (or 24 lines) ending where you ar 
''z+*' prints the next screenful. If you want less than 
screenful of lines do, e.g., ''z.l2'' to get 12 lines tot 
This method of giving counts works in general; thus you c 


delete 5 lines starting with the current 


command 


‘delete 5''. 


To find things in the file you can use 1 
happen to know them; since the line numb 
insert and delete lines this is somewhat 
can search backwards and forwards in the 
giving commands of the form /text/ to se 
text or ?text? to search backward for t 
reaches the end of the file without find 
wraps, end around, and continues to sear 
where you are. A useful feature here isl 
form /*text/ which searches for text at 
line. Similarly /text$/ sear dies for ^ 
line. You can leave off the trailing / 
commands. 


ine numbers if yo 
ers change when y 
unreliable. You 
file for strings 
larch forward for 
ext. If a search 


''; this is most 
inf' which print 


The current line has a symbolic name 
useful in a range of lines as in ".,$pr 
the rest of the lines in the file. To get to the last li 
in the file you can refer to it by its symbolic name 
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Thus the command $ delete or 


$d' 


line in the file, no matter which line was the current line 


before. Arithmetic with line references 


Thus the line $-5*' is the fifth before the last, and 


+ 20 ' 


is 20 lines after the present. 


You can find out which line you are at bU doing 
This is useful if you wish to move or copy a section of tfkxt 
within a file or between files. Find out the first and last 
line numbers you wish to copy or move (say 10 to 20). Fojr a 
move you can then say ''I0,20move “a*' which deletes these 


lines from the file and places them in a 
Edit has 26 such buffers named a through 
get these lines back by doing '"^“a move 
contents of buffer a after the current line. If you want 


is also possible 


by 


L 


buffer named a. 
z. You can later 
to put the 


to 
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move or copy these lines between files you can give an edit 
(e) command after copying the lines, following it with the 
ncune of the other file you wish to edit, i.e. "edit 
Ghapter2''. By changing move to copy above you can get a 
pattern for copying lines. If the text you wish to move or 
copy is all within one file then you can just say 
'l0,20move $'* for example. It is not necessary to use 
named buffers in this case (but you can if you wish). 

SEE ALSO 

ex(l), vi(l), 'Edit; A tutorial', by Ricki Blau and James 
Joyce 

AUTHOR 

William Joy 

BUGS 

See . 
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NAME 

egrep - search a file for a pattern 

SEE 

grep(l) 
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NAME 

ex - text editor 
SYNOPSIS 

ex C - ] C -V ] C -t tag ] C -r ] C tlineno ] name ... 
DESCRIPTION 

Ex is the root of a family of editors: edit, ex and vi* ^ 
is a superset of ed , with the most notable extension being a 
display editing facility. Display based editing is the 
focus of vi . 

If you have not used or are a casual user, you will find 

that the editor edit is convenient for you. It avoids some 
of the complexities of ex used mostly by systems programmers 
and persons very familiar with ed . 

If you have a CRT terminal, you may wish to use a display 
based editor; in tliis case see 2 ^( 1 ), vdiich is a command 
which focuses on the display editing portion of ex . 

DOCUMENTATION 

For edit and ex see the Ex/edit command summary - Version 
^.0. The document Edit : A tutorial provides a coraprehensive 
introduction to edit assuming no previous knowledge of 
corat>uters or the UMIX system. 

The Ex ‘ Reference M anual - Version 2^.0 is a comprehensive and 
complete manual for the command mode features of ex, but you 
cannot learn to use the editor by reading it. For an 
introduction to more advanced forras of editing using" the 
command mode of e5C see the editing documents written by 
Brian Kernighan for the editor ed; the material in the 
introductory and advanced documents works also with ex. 

An Introduction to Display Editing with Vi introduces the 
display editor vi and provides reference material on The 
Vi Quick Reference card summarizes the conroands of ^ in a 
useful, functional way, and is useful with the Introduction . 

FOR ED USERS 

If you have used ^ you will find that ex has a number of 
new features useful on CRT terminals. Intelligent terminals 
and high speed terminals are very pleasant to use with vi. 
Generally, the editor uses far more of the capabilities ^ 
terminals than ed does, and uses the terminal capability 
data base termcap (1) and the type of the terminal you are 

from the variable TERM in the environment to determine 
how to drive your terminal efficiently. The editor makes 
use <3f features such as insert and delete character and line 
in its visual command (which can be abbreviated vi) and 
which is the central mode of editing when using vi^). 
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There is also an interline editing opei| 
works on all terminals. 

Ex contains a number of new features fci 
text of the file. The z command gives 
windows of text, fitting ''D causes the| 
half-window of text and is more useful 
through a file than just hitting return 
screen oriented visual mode gives const 
context. 

Ex gives you more help when you make mi 
command allows you to reverse any singl 
astray. ^ gives you a lot of feedback 
changed lines, and indicates when more 
affected by a command so that it Is eas 
comraand has affected more lines than it 


The editor also normally prevents over*,, 
unless you edited them so that you don' 
clobber with a wri te a file other than 
editing 


Manual 


EX(1) 
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If the system (or editor) era 
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W|riting existing 
accidentally 
the one you are 
shes, or you 
use the editor 


Ex has several features for dealing with 
at a time. You can give it a-list of fi 
line and use the next (n) command to dea 
The next command can also be given a lis 
a pattern as used by the shell to sped 
to be dealt with. In general, filename|s 
be formed with full shell metasyntax, 
is also available in forming filenames 
the name of the current file. For edit), 
related files you can use ex'^ tag comm 
functions and other important points in 
This is useful-when working on a large 
to quickly find the definition of a par 
The command ctags (1) builds a tags file 
programs. 


For moving text between files and withiiji 
has a group of buffers, named a through 
text in these named buffers and carry it 
another file. 


There is a command & in which repeats 
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You can use the substitute cominand in ex to systematically 
convert the case of letters between upper and lower case. 

It is possible to ignore case of letters in searches and 
substitutions. Ex also allows regular expressions which 
match words to be constructed. This is convenient, for 
example, in searching for the word ''edit*' if your document 
also contains the word ''editor.'* 

Ex has a set of options which you can set to tailor it to 
your liking. One option which is very useful is the 
autolndent option which allows the editor to automatically 
supply leading white space to align text. You can then use 
the D key as a backtab and space and tab forward to align 
ne\f code easily. 


Miscellaneous new useful features include an intelligent 

(j) command which supplies white space between joined 
lines automatically, commands < and > which shift groups of 
lines, and the ability to filter portions of the buffer 
through commands such as sort. 


FILES 

/usr/lib/ex2.0strings 
/usr/lib/ex2.0recover 
/usr/lib/ex2.^preserve 
/ etc/terracap 
~/.exrc 
/tmp/E x nnnnn 
/tmp/Rx nnnnn 
/usr/preserve 


error messages 
recover command 
preserve command 

describes capabilities of terminals 
editor startup file 
editor temporary 
named buffer temporary 
preservation directory 


SEE ALSO 

awk(l), ed(l), grep(l), sed(l), edit(l), grep(l), 
termcap(1), vi(1) 


AUTHOR 

William Joy 


BUGS 

The undo command causes all marks to be lost on lines 
changed and then restored if the marked lines were changed. 


never clears the buffer modified condition. 

The z command prints a number of logical rather than 
physical lines. More than a screen full of output may 
result if long lines are present. 


File input/output errors don't print a name if the command 
line -' option is used. 


There is no easy way to do a single scan ignoring case. 
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Because 'of the implementation of the a 
512 bytes of argument list are allowed 


fguraents to next , 
there. 


The format of / etc / termcap and the larg 
capabilities of terminals used by the 
type setup to be rather slow. 


e number of 
Editor cause term: 


The editor does not warn if text is placed in named buffers 
and not used before exiting the editor 


only 


inal 


Null characters are discarded in input 
appear in resultant files. 


files, and cannot 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arg ... 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, 
the result is written on the standard output* Each token of 
the expression is a separate argument. 

The operators and keywords are listed below. The list is in 
order of increasing precedence, with equal precedence 
operators grouped. 

expr 1 expr 

yields the first expr if it is neither null nor '0', 
otherwise yields the second expr . 

expr fit expr ^ 

yields the first expr if neither expr is null or 0', 
otherwise yields '0^. 

expr relop expr 

where relop is one of < <- = 1* >~ >, yields if the 
indicated comparTsbn is true, '0' if false. The 
comparison is numeric if both expr are integers, 
otherwise lexicographic., 

expr + expr 

expr “ expr 

addition or subtraction of the arguments. 

expr * expr 

expr / expr 
expr % expr 

multiplication, division, or remainder of the 
arguments. 

expr ; expr 

The matching operator compares the string first 
argument with the regular expression second argument; 
regular expression syntax is the same as that of ed(1). 
The \(...\) pattern symbols can be used to select a 
portion of the first argument. Otherwise, the matching 
operator yields the number of characters matched ('0' 
on failure). 

( exp r ) 

parentheses for grouping. 

Examples': 
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To add 1 to the Shell variable a: 
a='expr $a + 1' 


significant 


To find the filename part (least 
pathname stored in variable a. Which ma 

Vs 


part) of the 
or may not contain 


expr $a : '.*/\(**\)' 'I' $a 
Note the quoted Shell metacharacters. 
SEE ALSO 

ed(l), sh(l), testCl) 


DIAGNOSTICS 

Expr returns the following exit codes: 

0 if the expression is neither null nor '0'/ 

1 if the expression is null or '0', 

2 for invalid expressions. 


?age 2 


(printed 8/22/83) 







FALSE(l) 


Nu Machine UNIX Progreunmer' s Manual 


FALSE(l) 


NAME 

true, false - provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True and false are usually used in a Bourne shell script. 
They test for the appropriate status "true" or "false” 
before running (or failing to run) a list of commands. 

EXAMPLE 

while false 
do 

command list 

done 

SEE ALSO 

csh(l), sh(l), true(l) 

DIAGNOSTICS 

False has exit status nonzero. 
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NAME 

fgrep - search a file for a pattern 

SEE 

grep(1) 
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NAME 

til - Fortran 77 compiler 
SYNOPSIS 

til C option ] ... file ... 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler. It accepts several 
types of arguments; 

Arguments whose names end with .f are taTcen to be Fortran 
77 source programs; they are compiled, and each object 
program is left on the file in the current directory whose 
name is that of the source with .o' substituted for .f . 

Arguments whose names end with .r' are taken to be Ratfor 
source programs; these are first transformed by tne 
preprocessor, then compiled by til . 

In the same way, arguments whose names end with .c' or .s' 
are taken to be C or assembly source programs and are 
compiled or assembled, producing a '.o' file. 

The following options have the same meaniiag as in £c(l). 

See id(l) for load-time options. 

—c Suppress loading and produce .o' files for each source 
file. 

-w Suppress all warning messages. If the option is 

'-w66', only Fortran 66 compatibility warnings are 

suppressed. 

-p Prepare object files for profiling, see prof (1). 

Name the final output file output instead of a.out . 
The following options are peculiar to f77 . 

-onetrip 

Compile DO loops that are performed at least once if- 
reached. (Fortran 77 DO loops are not performed at all 
if the upper limit is smaller than the lower limit.) 

-u Make the default type of a variable 'undefined' rather 
than using the default Fortran rules. 

-C Compile code to check that subscripts are within 
declared array bounds. 

—F Apply Ratfor preprocessor to relevant files, put the 

result in the file with the suffix changed to '.f, but 
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do not compile. 

-m Apply the M4 preprocessor to each 
transforming it with the Ratfor pr^ 

-Rx Use the string x as a Ratfor optio 
files. 


Other arguments are taken to be either 
arguments# or P77—compatible object pr< 
produced by an earlier run, or perhaps 
compatible routines. These programs, 
results of any compilations specified, 

order given) to produce an executable 
' _ __ > 


loader option 
’bgrams, typically 
libraries of F77-| 
•together with the 
are loaded (in tl:i| 
jirogram with name 


a. out 


FILES 


file.[frsc] 
file.o 
a. out 

/lib/f77passl 
/lib/fort 
/usr/lib/libF77.a 
/usr/lib/libl77.a 
/lib/libc.a 


input file 
object file 
loaded output 
compiler 
pass 2 

intrinsic function library 
Fortran l/O librarj^ 

C library, see section 3 


SEE ALSO 

S. I. Feldman, P. J. Weinberger, A For 
Compiler 

profTHT cc(l), ld(l), ratfor(l) 
DIAGNOSTICS 

The diagnostics produced by f77 itself 
self-explanatory. Occasional messages 
the loader. 


BUGS 


The Fortran 66 subset of the language 
extensively; the newer features have 


P7 


7(1) 


'.r' file before 
eprocessor. 

n in processing 


table Fortran 77 


are intended to 
may be produced 


^as been exercise<^ 
not. 
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NAME 

file - determine file type 


SYNOPSIS 

file file ... 


DESCRIPTION 

File performs a series of tests on each argument in an 
attempt to classify it. If an argument appears to be ascii, 
file examines the first 512 bytes and tries to guess its 
language. 


BUGS 

It often makes mistakes. In particular it often suggests 
that command files are C programs. 
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FIND(l) 


hierarchy for each 


SYNOPSIS 

find pathname-list expression 
DESCRIPTION 

Find recursively descends the director^ 
pathname in the pathname-list (i.e., one or more pathnajaes) 
seeking files that match a boolean expression written in the 
primaries given below. In the descrip|tions, the argument n 
is used as a decimal integer where +n jneans more than n, -n 
means less than n and n means exactly |i. 

-name filename 

True if the filename argument matches the current 
file name. Worinal Shell argument syntax may be 
used if escaped (watch out for '?* and 


-perm onum 


True if the file permission flags exactly match 
the octal number onum (see d imod (l)). If onun is 
prefixed by a minus sign, more flag bits (017777, 
see stat (2)) become significant and the flags 1 are 
compared; ( flag8 & onum )=» =onum 


-type c True if the type of the file 


c, d or f for block special character 

special file, directory or plain file. 


-links n True if the file has n links 
-user uname 

True if the file belongs to 
name or numeric user ID). 


the user uname (login 


-group gname 

True if the file belongs to ^roup gname (grouj|> 
name or numeric group ID). 


-Size n 

-inum n 
-atime n 
-mtime n 


True if the file is n blocks 
block). 


umber n. 


True if the file has inode n 
True if the file has been accessed in n days. 
True if the file has been modified in n days. 


-exec command 

True if the executed command 
as exit status. The end of 
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punctuated by an escaped semicolon. A command 
argument '{}' is replaced by the current pathname. 

-ok co-mmand 

Like -exec except that the generated command is 
written on the standard output, then the standard 
input is read and the conunand executed only upon 
response y. 

-print Always true; causes the current pathname to be 
printed. 

-newer file 

True if the current file has been modified more 
recently than the argument file . 

The primaries may be combined using the following operators 
(in order of decreasing precedence): 

1) A parenthesized group of primaries and operators 
(parentheses are special to the Shell and must be 
escaped). 

2) The negation of a primary ('!' is the unary not 
operator). 

3) Concatenation of primaries (the and operation is implied 
by the juxtaposition of two primaries). 

4) Alternation of primaries ('-o' is the or operator). 
EXAMPLE 

To remove all files named 'a.out* or '*.o' that liave not 
been accessed for a week: 

find / \(- -name a.out -o -name '*.o' \) -atirae +7 -exec rra 

(} \; 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

sh(l), test(l), filsys(5) 

BUGS 

The syntax is painful. 
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NAME 

fsck, sfsck - file system consistency check and interactive 
repair 

SYNOPSIS 

/etc/fsck [ -y ] C -n ] C -sX ] [ -SX ]] C -t filename ] C 
filesystem 3 .•• 

DESCRIPTION 

Fsck audits and interactively repairs inconsistent 
conditions for UNIX file systems. If the file system is 
consistent then the number of files, number of blocks used, 
and number of blocks free are rex>orted. If the file system 
is inconsistent the operator is prompted for concurrence 
before each correction is attempted. It should be note<l 
that most corrective actions will result in some loss oJ: 
data. The amount and severity of data lost may be 
determined from the diagnostic output. The default actj.on 
for each consistency correction is to \/ait for the operator 
to respond yes or no. If the operator does not have wri.te 
permission fsck will default to a —n action. 

Fsck has more consistency checks than its predecessors 
check , dcheck , fcheck , and icheck combined. 

fsck is a small version of fsck which will execute in 
systems with less memory but will run flower and may rec[uire 
a scratch file during its operation. 

The following flags are interpreted by fsck . 

-y Assume a yes response to all questions asked by f sck . 

-n Assume a no response to all questions asked by fsck; 
do not open the file system for writing. 

-sX Ignore the actual free list and [unconditionally) 

reconstruct a new one by rewritijig the super-bloc): of 
the file system. The file system should be unmounted 
while this is done; if this is not possible, care 
should be taken that the system is quiescent and i:hat 
it is rebooted immediately afterwards. This 
precaution is necessary so that the old, bad, in-core 
copy of the superblock will not continue to be ustjd, 
or written on the file system. 

The -sX option allows for creatijig an optimal free¬ 
list organization. The following forms of X are 
supported for the following devices; 

-sBlocks-per-cylinder;31ocks-to-skip (for anything 
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If X is not given, the values used when the filesystem 
was created are used. If these values were not 
specified, then the value 400 :9 is used. 

-SX Conditionally reconstruct the free list. This option 

is like -sX above except that the free list is rebuilt 
only if there were no discrepancies discovered in the 
file system. Using -S will force a no response to all 
questions asked by fsck. This option is useful for 
forcing free list reorganisation on uncontaminated 
file systems. 

-t If fsck cannot obtain enough memory to keep its 

tables, it uses a scratch file. If the -t option is 
specified, the file named in the next argument is used 
as the scratch file, if needed. Without the -t flag, 
fsck will prompt the operator for the name of the 
scratch file. The file chosen should not be on the 
filesystem being checked, and if it is not a special 
file or did not already exist, it is removed when fsck 
completes. 

If no filesystems are given to fsck then a default list of 

file systems is read from the file /etc/checklist. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more .than one inode or the free 
list. 

2. Blocks claimed by an inode or the free list outside 
the range of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks. 

Directory, size not 16-byte aligned. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 

Inode number out of range. 

8. Super Block checks: 

More than 65536 inodes. 

More blocks for inodes than there are in the 

file system. 

9. Bad free block list format. 

10. Total free block and/or free inode count incorrect. 


Orrjhajied files and directories (allocated but unreferenced) 
are, with the operator's concurrence, reconnected by placing 
them in the lost+found directory. The name assigned is the 
inode number. The only restriction is that the directory 
lost+found must preexist in the root of the filesystem being 
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checked and must have empty slots in which entries can be 
made. This is accomplished by making lost+found, copying a 
number of files to the directory, and then removing theid 
(before fsck is executed). 

Checking the raw device is almost always faster. 

• PILES 

/etc/checklist contains default list of file systems 

to check. 

DIAGNOSTICS 

The diagnostics produced by fsck are intended to be self- 
explanatory. 

SEE ALSO 

checklist(5), fs(5}, crash(8). 

BUGS 

Inode numbers for . and .. in each directory should be 
checked for validity. 

-g and -b options from check should be available in fsck . 
Fsck should understand about quotas. 


I 


i 


j 
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NAME 

get - get a version of an SCCS file 
SYNOPSIS 

? et C-rSID] C-ccutoff] C-ilist] C-xlist] C-aseq-no.] C-k] 

-e] [-![£]] C-p] C-m] [-n] C-s] C-b] C-g] C-t] file ... 

DESCRIPTION 

Get generates an ASCII text file from each named SCCS file 
according to the specifications given by its keyletter 
arguments, which begin with The arguments may be 
specified in any order, but all keyletter arguments apply to 
all named SCCS files. If a directory is named, get behaves 
as though each file in the directory were specified as a 
named file, except that non-SGCS files (last component of 
the path name does not begin with s.) and unreadable files 
are silently ignored. If a name of - is given, the standard 
input is read; each line of the standard input is taken to 
be the name of an SCCS file to be processed. Again, non- 
SCCS files and unreadable files are silently ignored. 

The generated text is normally written into a file called 
the g- file whose name is derived from the SCCS file name by 
simply removing the leading s.; (see also FILES , below). 

Each of the keyletter arguments is explained below as though 
only one SCCS file is to be processed, but the effects of 
any keyletter argument applies, independently to each named 
file. 

-rSID The ^CCS IDentification string (SID) of the 

versTon (3elta) of an SCCS file to be retrieved. 
Table 1 below shows, for the most useful cases, 
what version of an SCCS file is retrieved (as 
well as the SID of the version to be eventually 
created by delta (l) if the -e keyletter is also 
used), as a function of the SID specified. 

-c cutoff Cutoff date-time, in the form: 

yyCmmCddChhCmmCss]]]]] 

ilo changes (deltas) to the SCCS file which were 
created after the specified cutoff date-time are 
included in the generated ASCII text file. Units 
omitted from the date-time default to their 
maximum possible values; that is, -c7502 is 
equivalent to -c750228235959. Any nujaber of 
non-numeric characters may separate the various 2 
digit pieces of the cutoff date-time. This 
feature allows one to specify a cutoff date in 
the form: ''-c77/2/2 9:22:25". Note that this 
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-b 


-ilist 


-xlist 


implies that one may use the 
identification keywords (see 
gets within, say the input 


to 


iget "-c%E% %U%" s.file 


%E% and %U% 
below) for nested 
a send(1C) command: 


Indicates that the get is for 
editing or making a change (g 
file via a subsequent use of 
keyletter used in a get for 
(SID) of the sees file preve 
editing on the same SID unti^ 
or the j (joint edit) flag 
file (see admin (1))» Concur^ 
for different SIDs is always 


on 

for 


particular versg 
ijits further get s 
delta is executed 
set in the SCCS 
ent use of get 
allowed. 


If the g- file generated by 
keyletter is accidentally ru 
of editing it, it may be reg 
executing the get command wi 
in place of the -e keyletter 


et with an -e 
^ed in the process 
enerated by re- 
4h the -k keyletter 


SCCS file protection specific 
floor, and authorized user Ij. 
SCCS file (see admin (l)) are 
keyletter is used. 


Used with the -e keyletter t 
new delta should have an SID 
shown in Table 1. This keylje 
the b flag is not present in 
admin(1)) or if the retrieve 
(A leaf delta is one 


delta . _ 

successors on the SCCS file 
Note; A branch delta may alw| 
non-leaf delta . 

A list of deltas to be inclu 
applied) in the creation of 
The list has the following s 


<list> ; 
<range> 


<range> 1 <list> 
! SID 1 SID - SID 


SID, the SCCS Identification 
in any form shown in the "S 
of Table 1. Partial SIDs ar 
shown in the ''SID Retrieved 

A list of deltas to be excli:^ 
applied) in the creation of 
See the -i keyletter for the 


the purpose of 
elta) to the SCCd 
delta(1). The -e 


id via the ceiling 
st stored in the 
enforced when thi 


indicate that 
in a new branch 
tter is ignored 
the file (see 
d delta is not a 


th 


that has no 
tree.) 

ays be created frbm a 


ded (forced to be 
the generated fil 
yntax; 


<range> 


of a delta, may 
ID Specified'' co 
e interpreted as 
*' column of Tabl 

ded (forced not t 
the generated fil 
list forraat. 


-e 


e 

as 

if 

Leaf 


oe 

lumn 
e 1. 

o be 

e. 
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Suppresses replacement of identification keywords 
(see below) in the retrieved text by their value. 
The -k keyletter is implied by the -e keyletter. 

Causes a delta sununary to be written into an 1 - 
file. If -Ip is used then an 1- file is not 
created; the delta summary is written on the 
standard output instead. See FILES for the 
format of the 1- file . 

Causes the text retrieved from the SCCS file to 
be written on the standard output. No g- file is 
created. A.11 output which normally goes to the 
standard output goes to file descriptor 2 
instead, unless the -s keyletter is used, in 
which case it disappears. 

Suppresses all output normally written on the 
standard output. However, fatal error messages 
(which always go to file descriptor 2) remain 
unaffected. 

Causes each text line retrieved from the SCCS 
file to be preceded by the SIO of the delta that 
inserted the text line in the SCCS file. The 
format is: SID, followed by a horizontal tab, 
followed by the text line. 

Causes each generated text line to be preceded 
with the %M% identieication keyword value (see 
below). The format is: %M% value, followed by a 
horizontal tab, followed by the text line. When 
both the -m and -n keyletters are used, the 
format is: %M% value, followed by a horizontal 
tab, followed by the -m keyletter generated 
format. 

Suppresses the actual retrieval of text from the 
SCCS file. It is primarily used to generate an 
1- file , or to verify the existence of a 
particular SID. 

Used to access the most recently created 
{''top'') delta in a given release (e.g., -rl), 
or release and level (e.g., -rl.2). 

. The delta sequence number of the SCCS file delta 
(version) to be retrieved (see sees f ile (5)). 

This keyletter is used by the comb (T) command; it 
is not a generally useful keyletter, and users 
should not use it. If both the —r and —a 
keyletters are specified, the —a keyletter is 
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used. Care should be taken 
keyletter in conjunction wit 
as the SID of the delta to bje 
what one expects. The -r key 
with the -a and -e keyletters 
naming of the SID of the delt 


^hen using the -a 
the -e keylettet, 
created may not be 
letter can be used 
to control the 
a to be created. 


For each file processed, get responds ( 
output) with the SID being accessed and 
lines retrieved from the SCCS file. 


pn the standard 
with the number 


If the -e keyletter is used, the SID of 
appears after the SID accessed and befojr 
lines generated. If there is more than 
a directory or standard input is named, 
printed (preceded by a new-line) before 
the -i keyletter is used included delta^ 
following the notation ''included*'; if 
used., excluded deltas are listed follow! 

''Excluded''. 

center expand ; c s s s s cl cl cl cl c0 c c 

TABLE 1. Determination of SCCS Identificatioh String 


s* SID* -b Keyletter Other SID SID of 

Specified Used+ Conditions Retrieved 
= none^ no R defaults to raR mR.mL 
none^ yes R defaults to mR mR.mL 

= R no R > mR mR.mL R.l*** _ R 

mR mR.mL mR.(mL+1) _ R yes R > 

ciiR mR.mL mR.mL. (mB+1). 1 _R yes 

mR mR.mL mR.mL.(mB+1).1 _ R - 

and ■ hR.mL** hR.mL.(mB+1).1 
exist _ R - Trunk succ.# 

in release > R 

Wo trunk succ. R.L R.(L+1) _ 

Trunk 


= R.L no 

succ. R.L R.L.(mB+1).1 _ R.L 
succ. R.L R.L.(mB+1).1 
= R.L.B no No branch succ. 
R.L.8 yes Wo branch succ. 

= R.L.B.S no No branch succ. 
R. L. B. S 
R.L.B.S 


GEt(l) 


the delta to be pade 
a the number of 
one named file o! if 
each file name is 
it is processed. If 
are listed 
the -X keyletter|is 
ng the notation 


of 


CGClclll 


pelta 

to be Created 
mR. (mL+1) __ 
mR.mL. (mB+l). 1 
no R = 


< loR 

does not 
R.iiL R.mL. (mB+1). 1 
and R exists 
R.L yes No trunk 


in release ^ R 
R.L.B.mS R.L.B.(mS+1) 


yes No branch succ. 


R.L.B.mS 

R.L.B.S 

R.L.B.S 


Branch succ. R.L.B.S R.L.(mB+1).I 




I I 


% \ 


R 

level 


I I 

' $ 
\ \ 


B 


' ’, and "s'* 

'* ''branch'*, and ''seque 
the SID, respectively; ''ra*' means 
for example, ''R.mL'' means ''the 

II. '' 


R.mL 

within release R*'; ''R.L.(raB+1). 
sequence number on the new branch 
branch number plus one) of level : 
Note that if the SID specified is 
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R.L.(mB+1).1 
R.L.B.(S+1) 
R.L.(raB+1),1 


nee 

\ % 


ar(i the ' release' ' 

components of 
maximum* ' . Tlius, 
maximum level number 
*' means ''the first 
(i.e., maximum 
1 within release R* 
of the form ''R.li* 
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"R.L.B'', or "R.L.B.S", each of the specified 
components must exist. 

** "hR*' is the highest existing release that is lower 
than the specified, nonexistent , release R. 

*** This is used to force creation of the first delta in a 
new release. 

# Successor. 

+ The -b kayletter is effective only if the b flag (see 

admin(l)) is present in the file. An entry of - means 
^ ^irrelevant''. 

4 This case applies if the d (default SID) flag is not 

present in the file. If the d flag is present in the 
file, then the SID obtained from the d flag is 
interpreted as if it had been specified on the command 
line." Thus, one of the other cases in this table 
applies. 

IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved 
from the SCCS file by replacing identification keywords with 
their value wherever they occur. The following keywords may 
be used in the text stored in an SCCS file; 


Keyword 

%M% 


%I% 

%R% 

%L% 

%B% 

%S% 

% 0 % 

%H% 

%T% 

%E% 

%G% 

%U% 

%Y% 

%F% 

%P% 

%Q% 

%C% 


%Z% 


Value 

Module name: either the value of the m flag in the 
file (see admin(l)), or if absent, the name of the 
sees file with the leading s. removed. 

SCCS identification.(SID) (%R%.%L%.%B%.%S%) of the 
retrieved text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY/MM/DD). 

Current date (MM/DD/YY). 

Current time (HH;MM:SS). 

Date newest applied delta was created (YY/MM/DD). 
Date newest applied delta was created (MM/DD/YY). 
Time newest applied delta was created (HH;MM;SS). 
Module type; value of the t flag in the SCCS file 
(see admin (l)). 

SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see 
admin(1)). 

Current line number. This keyword is intended for 
identifying messages output by the program such as 
''this shouldn't have happened'' type errors. It 
is not intended to be used on every line to 
provide sequence numbers. 

The 4-character string @(#) recognizable by 
what(1). 
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A shorthand notation for cons|.ructing what (1) 
strings for UNIX program files. 

%W% = %z%%M%<horizontal-tab>%I% 

Another shorthand notation for constructing 
what(l) strings for non-UNIX program files. 
%A% = %Z%%Y% %M% %I%%Z% 


FILES 


Several auxiliary files may be created 
are known generically as the g- file , 
file . The letter before the hyphen is 
auxiliary file name is formed from the 
last component of all SCCS file names m> 
s. module-name I the auxiliary files are 
the leading s with the tag. The g- file 


z- 

An 


this scheme: the g- file is named by rerab 
For example/ s.xyz.c, the auxiliary file 
xyz.C/ l.xyz.c, p.xyz.c, and z.xyz.c. 


by get / These filbs 
jgile , p- file / and 
called the tag. 
sees file name: the 
ust be of the forta 
rjiamed by replacing 
is an exception to 
ving the s. prefJ.x 
names would be 
spectively. 


re 


The g-file/ which contains the generateep 
the current directory (unless the -p ke 
g- file is created in all cases/ whether 
text were generated by the get . It is 
user. If the -k kayletter is used or i 
644; otherwise its mode is 444. Only 
have write permission in the current dir 


th' 


The l-:y.le contains a table showing whi<ph deltas -were 

The 1-file is 


applTed in generating the retrieved text: 
created in the current directory if the 
used; its mode is 444 and it is owned bV 
Only the real user- need have write perm^ 
directory 


Lines in the 1-file have the following 


X' 

^ I I 


text/ is created in 
^letter is used). A 
or not any lines of 
<bwned by the real 
ijnplied its mode i^ 
e real user need 
ectory. 


-1 keyletter is 
the real user, 
ssion in the cur 


format; 


*age 


a. A blank character if the delta was applied; 

* otherwise. 

b. A blank character if the delt^ was applied or 
wasn't applied and ignored; 

* if the delta wasn't applied 

c. A code indicating a "special 
delta was or was not applied; 

Included. 

''• Excluded. 

Cut off (by a -c 

d. Blank. 

e. SCCS identification (SID). 

f. Tab char.acter. ■ 

g. Date and time (in the form YY/mm/DD till:MM;SS) <|)f 
creation. 

h. Blank. 
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i. Login name of person who created delta . 

The comments and MR data follow on subsequent lines, 
indented one horizontal tab character. A. blank line 
terminates each entry. 

The p-file is used to pass information resulting from a get 
with an -e keyletter along to delta . Its contents are also 
used to prevent a subsequent execution of get with an -e 
keyletter for the same SID until delta is executed or the 
joint edit flag, j, (see admin (l)) is set in the SCCS file. 
The p-file is created in the directory containing the SCCS 
file^and the effective user must have write permission in 
that directory. Its mode is 644 and it is owned by the 
effective user. The format of the p- file is: the gotten 
SID, followed by a blank, followed by the SID that the new 
delta will have when it is made, followed by a blank, 
followed by the login name of the real user, followed by a 
blank, followed by the date-time the get was executed, 
followed by a blank and the -i keyletter argument if it was 
present, followed by a blank and the -x keyletter argument 
if it was present, followed by a new-line. There can be an 
arbitrary number of lines in the p- file at any time; no two 
lines can have the same new delta SID. 

The z- file serves as a lock-out mechanism against 
simultaneous updates. Its contents are the binary (2 bytes) 
process ID of the command (i.e., get ) that created it. The 
z- fil e is created in the directory containing the SCCS file 
Tor the duration of get . The same protection restrictions 
as those for the p- file apply for the z- file . The z- file is 
created mode 444. 

SEE ALSO 

adrain(l), delta(l), help(l), prs{l), what(l), sccsfile(5). 
Source Code Contro l System User 's Guide by L. E. Bonanni and 
C. A.~Salemi. 

DIAGNOSTICS 

Use help (1) for explanations. 


BUGS 

If the effective user has write permission (either 
explicitly or implicitly) in the directory containing the 
SCCS files, but tile real user doesn't, then only one file 
may be named when ihe -e keyletter is used. 
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NAME 


getty - set terminal type, modes, spe^i 
dlsoipline 


SYNOPSIS 

/etc/getty C -h ] C -t timeout ] line C 
linedisc ] ] ] 

/etc/getty -c file 

DESCRIPTION 

Getty is a program that is invoked by j. 


second process in the series, ( init-get 


GETTY 


d, and line 


speed C type C 


^t (IM). It is t: 


[ty-login-shell ) t 


(IM) 


le 

hat 


ultimately connects a user with the UNIX System. Initially 
getty prints the login message field for the entry it is 
using from /etc/gettydefs. Getty reads the user's login 
name and invokes the login (l) command with the user's name 
as argument. While reading the name, g etty attempts to 


adapt the system to the speed and type jof terminal being 
used. 

Line is the name of a tty line in /dev to which getty is 
attach itself. Getty uses this string as the name of a 
in the /dev directory to open for reading and writing. 
Unless getty is invoked with the -h flag, getty will forj: 
hangup on the line by setting the speed] 
setting the speed to the default or ape 
flag plus timeout in seconds, specifies 
exit if the open on the line succeeds a 


anything in the specified number of seconds. The optional 


second argument, speed , is a label to a 
definition in the file /etc/gettydefs. 
tells getty what speed to initially run 
message should look like, what the init 
and what speed to try next should the u 
speed is inappropriate. (By typing a < break > character.) 
default speed is 300 baud. 
type 


to 

file 


Thfe 


to zero before 
jcified speed. 

that getty shoulji 
hd no one types 


speed and tty 
This definition 
at, what the logf 
kl tty settings a: 
ser indicate that 


The optional third argument. 


_is a character string describing jio getty what typ^ 

terminal is connected to the line in question. Getty 
understands the following types; 

none default 

vt61 DEC vt61 

vtl00 DEC vtl00 

hp45 Hewlett-Packard HP45 

cl00 Concept 100 


The default terminal is nonep; i.e., any 
terminal unknown to the system. Also, 
have any meaning, the virtual terminal 
compiled into the operating system. Thk 
not compiled in the default condition, 
argument, linedisc, is a character strik 


:e a 

-t 


n 

the 

The 


of 


crt or normal 
for terminal type|to 
handlers must be 
y are available, but 
The optional foui’th 
ig describing which 
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line discipline to use in communicating with'the terminal. 
Again the hooks for line disciplines are available in the 
operating system but there is only one presently available, 
the default line discipline, LOISC0. 

When given no optional arguments, getty sets the speed of 
the interface to 300 baud, specifies that raw mode is to be 
used (awaken on every character), that echo is to be 
suppressed, either parity allowed, newline characters will 
be converted to carriage return-line feed, and tab expansion 
performed on the standard output. It types the login 
message before reading the user's name a character at a 
time. If a null character (or framing error) is received, 
it is assumed to be the result of the user pushing the 
''break* ' key. This will cause getty to attempt the next 
spee d in the series. The series that getty tries is 
determined by what it finds in /etc/gettydefs. 

The user's name its terminated by a new-line or carriage- 
return character. The latter results in the system being 
set to treat carriage returns appropriately (see ioctl (2)). 

The user's name is scanned to see if it contains any lower¬ 
case alphabetic characters; if not, and if the name is non¬ 
empty, the system is told to map any future upper-case 
characters into the corresponding lower-case characters. 

Finally, login is called with, the user's name as an 
argument. Additional arguments may be typed after the login 
neune. These are passed to login , which will place them in 
the environment (see login (1)). 

A check option is provided. When getty is invoked with the 
-c option and file , it scans the file as if it were scanning 
/etc/gettydefs and prints out the results to the standard 
output. If there are any unrecognized modes or improperly 
constructed entries, it reports these. If the entries are 
correct, it prints out the values of the various flags. See 
ioctl (2) to interpret the values. Note that some values are 
added to the flags automatically. 


PILES 

/etc/gettydefs 


SEE ALSO 

ct(lC), init(lM), login(l), ioctl(2), gettydefs(4), 
inittab(4), ,tty(7). 
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NAME 


graph - draw a graph 


SYNOPSIS 

graph [ option ] ... 

DESCRIPTION 

Graph with no options takes pairs of n 
standard input as abscissas and ordina^ 
Successive points are connected by str 
graph is encoded on the standard outpu-^ 
plot(1) filters. 


If the coordinates of a point are followed by a nonnume:|‘ 
string, that string is printed as a label beginning on 
point. Labels may be surrounded with quotes in 


Manual 


GRAPH(IG) 


Ambers from the 
es of a graph. 

^ight lines. The 
for display by the 


case they may be empty or contain blanljcs and numbers; 
never contain newlines. 


The following options are recognized, each as a separat^ 
argument. 


-a 


-b 

-c 

-g 

-1 

-m 

-s 


Supply abscissas automatically (they are missing f:|’ora 
the input); spacing is given by the next argument 
(default 1). A second optional argument is the 
starting point for automatic abscfssas (default 0 <j)r 
lower limit given by -x). 

Break (disconnect) the graph aftef each label in tljie 
input. 

Character string given by next argument is default, 
label for each point. 


Next argument is grid style, 0 no 
ticks, 2 full grid (default). 

Next argument is label for graph. 


Next argument is mode (style) of connecting lines: 
disconnected, 1 connected (default). Some devices 
distinguishable line styles for other small integeij’s 

Save screen, don't erase before plotting. 


14 


grid, 1 frame with 


1C 

the 

which 

bels 


-X C 1 ] 

If 1 is present, x axis is logarithmic. Next 1 (oij’ 2) 
arguments are lower (and upper) x 
argument, if present, is grid spacing on x axis 
Normally thesi3 quantities are determined automatically- 

-y C 1 ] 


0 

give 
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Similarly for 

-h Next argument is fraction of space for height. 

-w Similarly for width. 

-r Next argument is fraction of space to move right before 
plotting. 

-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x now 
applies to the vertical axis.) 

A legend indicating grid range is produced with a grid 
unless the -s option is present. 

If a specified lower limit exceeds the upper limit, the axis 
is reversed. 

SEE ALSO 

splineCl), plot(l) 


BUGS 

Graph stores all points internally and drops those for which 
there isn't room. 

Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 

grep, egrep, fgrep - search a file for a pattern 
SYNOPSIS 

grep [ option ] ... expression C file ] ... 
egrep C option H ... C expression 3 C file ] ... 
fgrep C option 3 ... C strings 3 C file 3 
DESCRIPTION 

Commands of the grep family search the input files (standard 
input default) for lines matching a pattern. Normally, each 
line found is copied to the standard outijut; unless the -h 
flag is used, the file name is shown if there is more than 
one input file. 

Grep patterns are limited regular expressions in the style 
of ed(l); it uses a compact nondeterrainistic algorithm. 

Egrep patterns are full regular expressions; it uses a fast 
deterministic algorithm that sometimes needs exponential 
space. Fgrep patterns are fixed strings; it is fast and 
compact. 

The following options are recognized. 

-V All lines but those matching are printed. 

-c Only a count of matching 'lines is printed. 

-1 The naunes of files with matching lines are listed 
(once) separated by newlines. 

-n Each line is preceded by its line number in the file. 

-b Each line is preceded by the block number on which it 

was found. This is sometimes useful in locating disk 
block numbers by context. 

-s No output is produced, only status. 

-h Do not print filename headers with output lines. 

-y Lower case letters in the pattern will also match upper 
case letters in the input ( grep only). 

-e expression 

Same as a simple expression argument, but useful when 
the expressio n begins with a -. 

-f file 

The regular expression ( egrep ) or string list ( fgrep ) 
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is taken from the file . 

-X (Exact) only lines matched in their entirety are 
printed ( fgrep only). 

Care should be taken when using the characters 
" ( ) and \ in the expression as they are also meaningful to 
the Shell. It is safest to enclose the entire expression 
argument in single quotes ' '. 

Fgre p searches for lines that contain one of the (newline- 
separated) strings . 

Egre p accepts extended regular expressions. In the 
following description 'character' excludes newline: 

A. \ followed by a single character matches that 
character. 

The character '' ($) matches the beginning (end) of a 
line. 

A . matches any character. 

A single character not otherwise endowed with special 
meaning matches that character. 

A string enclosed in brackets [] matches any single 
character from the string. Ranges of ASCII character 
codes may be abbreviated as in 'a-z0-9'. A 3 may occur 
only as the first character of the string. A literal - 
must be placed where it can't be mistaken as a range 
indicator. 

A regular expression followed by * (+/ ?) matches a 
sequence of 3 or more (1 or more, 3 or 1) matches of 
the regular expression. 

Two regular expressions concatenated match a match of 
the first followed by a match of the second. 

Two regular expressions separated by 1 or newline match 
either a match for the first or a match for the second. 

A regular expression enclosed in parentheses matches a 
match for the regular expression. 

The order of precedence of operators at the same parenthesis 
level is C3 then *+? then concatenation then I and newline. 

SEE ALSO 

ed(l), sed(i), sh(l) 
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DIAGNOSTICS 

Exit status Is 0 if any matches are fouijii 
syntax errors or inaccessible files. 


BUGS 


Ideally there should be only one grep / 
single algorithm that spans a wide enou 
time tradeoffs. 


Lines are limited to 256 characters; loijiger lines are 
truncated. 


GREPd) 


id, 1 if none, 2 for 


put we don't know 
gh range of space+ 
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NAME 

head - give first few lines of a stream 
SYNOPSIS 

head C -count ] [ file ... ] 

DESCRIPTION 

This filter gives the first count lines of each of the 
specified files, or of the standard input. If count is 
omitted it defaults to 10. 

SEE ALSO 

tail{l) 


AUTHOR 

Bill Joy 
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NAME 

help - ask for help 

SYNOPSIS 

help Cargs] 

DESCRIPTION 

Help finds information to explain a mesisage from a command 
or explain the use of a command. Zero or more arguments r 
be supplied. If no arguments are given, help will prompt 
for one. ^ 


The argt^ents may be either message nunlbers (which normally 
appear in parentheses following messagejs) or command naqes, 
of one of the following types; 

type 1 Begins with non-nunlerics, ends in 

numeric prefix is 
tion for the program 


numerics. The non- 
usually an abbrevia 


or set of routines which produced the 


message (e.g., ge6, 
the get command) 


type 2 


type 3 Is all numeric (e.g 

The response of the program will be the 
information related to the argument, if 

\"?hen all else fails, try ''help stuck' 


FILES 


/usr/lib/help 


for message 6 from 


Does not contain numerics (as a command, 
such as get) 


, 212 ) 

explanatory 
there is any. 


directory containing files of messagi 
text. 


DIAGNOSTICS 

Use help d) for explanations 
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NAME 

init, telinit - process control initialization 

SYNOPSIS 

/etc/init C0123456SsQq] 

/etc/telinit [0123456sSQqabc] 

DESCRIPTION 

Init 

Init is a general process spavmer. Its primary role is to 
create processes from a script stored in the file 
/etc/inittab (see inittab (4)). This file usually has init 
spawn getty *s on each line that a user may log in on. It 
also controls autonomous processes required by any 
particular systera. 

Init considers the system to be in a run-level at any given 
time. A run - level can be viewed as a software configuration 
of the systera where each configuration allows only a 
selected group of processes to exist. The processes spawned 
“^nit for each of these run-levels is defined in the 
init bab file. Init can be in one of eight run-leve ls, 0-6 
and S or s. The run-level is changed by having a privileged 
user run /etc/init (which is linked to /etc/telinit). This 
user spawned init sends appropriate signals to the orginal 
init spawned by the operating systein when the system was 
rebooted, telling it which run-level to change to. 

Init is invoked inside the UNIX System as the last step in 
the boot procedure. The first thing init does is to look 
for /etc/inittab and see if there is an entry of the type 
initdefault (see inittab (4)). If there is, init uses the 
run-level specified in that entry as the initial run-level 
to enter. If this entry is not in inittab or inittab is not 
found, init requests that the user enter a run-level from 
the virtual systera console, /dev/syscon. If an S (s) is 
entered, init goes into the SINGLE USER level. This is the 
only run-level that doesn't require the existence of a 
properly formatted inittab file. If /etc/inittab doesn't 
exist, then by default the only legal run-level that init 
can enter is the SINGLE USER level. In the SINGLE USER 
level the virtual console terminal /dev/syscon is opened for 
reading and writing and the command /bin/su is invoked 
immediately. To exit from the SINGLE USER run-level one of 
two options can be elected. First, if the shell is 
terminated (via an end-of-file), init will reprompt for a 
new run - level . Second, the init or telinit command can 
signal init and force it to change the run-level of the 
system. 

When attempting to boot the systera, failure of init to 
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prompt for a new run-level may be due to 
device /dev/syscon is linked to a device 
physical system teletype (/dev/systty). 

can be forced to relink /dev/syscoi^ by typing a delejb 
on the system teletype which is co-locatjed with the 
processor. 


anual 


INIT(iM) 


the fact that th^ 
other than the 
If this occurs. 


'-iTlien init prompts for the new run-level , 
only enter one of the digits 0 through 6 
s. If S is entered init operates as pre 
SINGL E USER mode with the additional res 
is linked to the user's terminal line, 
virtual system console. A message is ge 
physical console, /dev/systty, saying wh^ 
terminal has been relocated. 


the operator may 
or the letters S 
iviously described, 
ialt that /dev/sys^i 
us making it the 
ijierated on the 
re the virtual 


th 


When init comes up initially and whenever 
SINGLE USER State to normal run states, 
states of the virtual console, /dev/sysc^: 
saved in the file /etc/ioctl.syscon. Thi 
by init whenever SINGLE USER mode is ent 
doesn't exist when init wants to read it 
printed and default settings are assumed 


it switches out 
it sets the ioctl 


n, to those modes 
s file is written 
^red. If this file 
a warning is 


If a 0 through 6 is entered init enters 
run-level . Any other input will be rej 
will be re-prompted. If this is the fir^ 
entered a run-level other than SINGLE USE 


ec 


inittab for special entries of the type l^ot and bootwait 
These entries are performed, providing 


matches that of the entry before any nor 
inittab takes place. In this way any sp 
of the operating system,such as mounting 
take place before.users are allowed onto 
inittab file is scanned to find all entri 
processed for that run-level. 


Run-level 2 is usually defined by the user to contain all of 
the terminal processes and daemons that spawned in the 
multi-user environment. 


^he corresponding 
ted and the user 
t time init has 
iJR, init first scA 


ns 

the run-level entered 

on 


rnal processing of 
t^cial initializati 
file systems, cari 
the system. The 
es that are to b4 


or 

in 

ion 


of 

( 2 ) 


In a multi-user environment, the inittab 
up so that init will create a process foif 
the system. 


For terminal processes, ultimately the sh 
because of an end-of-file either typed e 
generated as the result of hanging up. \ 
child death signal, telling it that a pro 
died, it records the fact and the reason 
/etc/utrap and /etc/wtmp if it exists (see 
history of the processes spawned is kept 


file is usually set 
each terminal on 


ell will terminatl 
xplicitly or 
i'fhen ini t receives a 
cess it spawned h|as 
it died in 
who (l)) . A 
in /etc/wtmp if 
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such a file exists. 

To spavm each process in the inittab file, init reads each 
entry and for each entry which should be respawned, it forks 
a child process. After it has spawned all of the processes 
specified by the inittab file, init waits for one of its 
descendant processes to die, a powerfail signal, or until 
init is signaled by init or telinit to change the system's 
run—level . When one of the above three conditions occurs, 
init re-examines the inittab file. New entries can be added 
to the inittab file at any time; however, init still waits 
for one of the above three conditions to occur. To provide 
for an instantaneous response the init Q or init q command 
can wake init to re-examine the inittab file. 

If init receives a pov/erfail signal ( SIGPWR ) and is not in 
SINGLE USER mode, it scans inittab for special powerfail 
entries. These entries are invoked (if the run-levels 
permit) before any further processing takes place. In this 
way init can perform various cleanup and recording functions 
whenever the operating system experiences a power failure. 

It is important to note that the powerfail entries should 
not use devices that must first be initialized (e.g. dzb 
lines) after a power failure has occurred. 

l^hen init is requested to change run-levels (via telinit), 
init sends the warning signal (SIGTERM) to all processes 
that are undefined in the target run-level . Init waits 20 
seconds before forcibly terminating these processes via the 
kill signal (SIGKILL), 

Telinit 

Telinit , which is linked to / etc / init , is used to direct the 
actions of init . It takes a one character argument and 
signals init via the kill system call to perform the 
appropriate action. The following arguments serve as 
directives to init . 

0-6 tells init to place the system in one of the 

run-levels 0-6. 

a,b,c tells init to process only those /etc/inittab 
file entries having the a, b or c run-level 
set. 

Q,q tells init to re-examine the /etc/inittab 

file. 

s,S tells init to enter the single user 

environment. When this level change is 
effected, the virtual system teletype, 
/dev/syscon, is changed to the. terminal from 
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which the command was executed. 

Telinit can only be run by someone who is super-user or a 
member of group sys. ^ 


FILES 

/etc/inittab 
/etc/utmp 
/etc/wtmp 
/etc/ioctl.syscon 
/dev/syscon 
/dev/systty 

SEE ALSO 

getty(lM), login(l), sh(l), who(l), kill 
utrap(4). 

DIAGNOSTICS 

If Init finds that it is continuously re 
from /etc/inittab more than 10 times in 


assume that there is an error in the conmand string, and 
generate an error message on the system console, and refu 
to respawn this entry until either 5 minutes has elapsed 
it receives a signal from a usee init (t elinit ). This 
prevents init from eating up system resq 
makes a typographical error in the initt 
is removed that is referenced in the ini 


(2), inittab(4). 


spawning an entry| 
2 minutes, it wil 


urces when someon 
ab file or a prog 
ittab. 


se 

or 

e 

ram 
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NAME 

iostat - report l/o statistics 
SYNOPSIS 

iostat C option ] ... [ interval [ count ] ] 

DESCRIPTION 

Iostat delves into the system and reports certain statistics 
kept about input-output activity. Information is kept about 
up to three different disks (DK0, SWAP, DKl) and about 
typewriters. For each disk, 10 completions and number of 
words transferred are counted; for typewriters collectively, 
the number of input and output characters are counted. 

Also, each sixtieth of a second, the state of each disk is 
examined and a tally is made if the disk is active. The 
tally goes into one of four categories, depending on whether 
the system is executing in user mode, in 'nice* (background) 
user mode, in system mode, or idle. From all these numbers 
and from the known transfer rates of the devices it is 
possible to determine information such as the degree of 10 
overlap and average seek times for each device. 

The optional interval argument causes iostat to report once 
interval seconds. The first report is for all time 
since a reboot and each subsequent report is for the last 
interval only. 

The optional count argument restricts the number of reports. 

With no option argument iostat reports for each disk the 
number of transfers per minute, the milliseconds per average 
seek, and the milliseconds per data transfer exclusive of 
seek time. It also gives the percentage of time the system 
has spend in each of the four categories mentioned above. 

The following options are available; 

-t Report the number of characters of terminal 10 per 
second as well. 

-i Report the percentage of time spend in each of the four 
categories mentioned above, the percentage of time each 
disk was active (seeking or transferring), the 
percentage of time any disk was active, and the 
percentage of time spent in 'lO wait;' idle, but with a 
disk active. 

-s Report the raw timing information; 32 numbers 

indicating the percentage of time spent in each of the 
possible configurations of 4 system states and 8 10 
states (3 disks each active or not). 
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-b Report on the usage of 10 buffers. 

FILES 

/dev/kmem/ /unix 
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NAME 

join - relational database operator 
SYNOPSIS 

join C options ] filel file2 
DESCRIPTION 

Join forms, on the standard output, a join of the two 
relations specified by the lines of filel and file2 . If 
filel is the standard input is used. 

Filel and file2 must be sorted in increasing ASCII collating 
sequence on the fields on which they are to be joined, 
normally the first in each line. 

There is one line in the output for each pair of lines in 
filel and file2 that have identical join fields. The output 
line normally consists of the common field, then the rest of 
the line from filel , then the rest of the line from file2 . 

Fields are normally separated by blank, tab or newline. In 
this case, multiple separators count as one, and leading 
separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produce a line for 
each unpairable line in file n, vdiere n is 1 or 2. 

-e £ Replace empty outi^ut fields by string £. 

-jn m 

Join on the mth field of file n. If n is missing, use 
the mth field in each file. 

-o list 

Each output line comprises the fields sped fed in list , 
each element of which has the form n.ra, v»here n is a 
file number and m is a field number. 

-t^ Use character c as a separator (tab character). Every 
appearance of £ in a line is significant. 

SEE ALSO 

sort(l), comm(l), awk(l) 


BUGS 

With default field separation, the collating sequence is 
that of sort -b; with -t, the sequence is that of a plain 
sort. 

The conventions of join , sort , comm , uniq , look and awk (1) 
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NAME 

kill - teanninate a process with extreme prejudice 
SYNOPSIS 

kill C -signo ] processid ... 

DESCRIPTION 

Kill sends signal 15 (terminate) to the specified processes. 
If a signal number preceded by is given as first 
argument, that signal is sent instead of terminate (see 
signal (2)). This will kill processes that do not catch the 
signal; in particular 'kill -9 is a sure kill. 

By convention, if process number 0 is specified, all members 
in the process group (i.e. processes resulting from the 
current login) are signaled. 

The killed processes must belong to the current user unless 
he is the super-user. To shut the system down and bring it 
up single user the super-user may use 'kill -1 1*; see 
init (8). 

The process number of an asynchronous process started with 
&* is reported by the shell. Process numbers can also be 
found by using ps(l). 

SEE ALSO 

ps(l), kill(2), signal(2) 
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NAME 


Id - loader 


SYNOPSIS 

Id C option ] file 

DESCRIPTION 

Ld combines several object programs into 


one. 


_ resolves 

external references, and searches libraries. In the 
simplest case several object files are given, and Id 
combines them, producing an object module which can be 
either executed or become the input for a further ^ run. 
(In the latter case, the -r option must lie given to preser| 
the relocation bits.) The output of 1^ is left on a.out. 
This file is made executable only if no errors occurred 
during the load. 

The argument routines are concatenated iri the order 


LD 


1 ) 


specified. The entry point of the output[ 
of the first routine. 

If any argument is a library, it is searc 
the point it is encountered in the argume 
those routines defining an unresolved ext 
loaded. If a routine from a library refe 
routine in the library, and the library li 
processed by ranlib (l), the referenced rc 
after the referencing routine in the libr 
order of programs within libraries may be 

first member of a library is named *_.S 

understood to be a dictionary for the lib 
produced by ranlib ; the dictionary is sea 
to satisfy as many references as possible 


at 


re 


hed exactly once 
nt list. Only 
ernal reference a| 
rences another 
as not been 
utine must appear] 
ary. Thus the 
important. If the 
DEF’, then it is 
rary such as 
rched iteratively] 


;ymi 


The symbols '_etext', '_edata* and '_end' 
and 'end* in C) are reserved, and if refej 
the first location above the program, the 
above initialized data, and the first lod 
data respectively. It is erroneous to del 


Ld understands several options. Except :^or -1, they shoul 
appear before the file names. 


-s 


'strip' the outrjut, that is, remove 
and relocation bits to save space (b] 
usefulness of the debugger). This i 
be removed by strip (1). 


is the beginning 


ve 


('etext', 'edata 
rred to, are set to 
first location 
ation above all 
fine these symbol 


the symbol table 
ut impair the 
nformation can al 


-u 


Take the following argument as a sym] 
undefined in the symbol table. This 
loading wholly from a library, since 
symbol table is empty and an unresol 


bol and enter it 
is useful for 
initially the 
Ived. reference is 
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needed to force the loading of the first routine. 

-lx This option is an abbreviation for the library name 

'/lib/libjc.a', where x is a string. If that does not 
exist, 3^ tries '/usr/lib/libx.a'. A library is 
searched when its name is encountered, so the placement 
of a -1 is significant. 

-X Do not preserve local (non-.globl) symbols in the 

output symbol table; only enter external symbols. This 
option saves some space in the output file. 

-X Save local symbols except for those whose names begin 
with 'L'. This option is used by cc(l) to discard 
internally generated labels while retaining symbols 
local to routines. 

-r Generate relocation bits in the output file so that it 
can be the subject of another run. This flag also 
prevents final definitions from being given to common 
symbols, and suppresses the 'undefined symbol* 
diagnostics. 

-d Force definition of common storage even if the -r flag 
is present. 

-n Arrange that when the output file is executed, the text 
portion will be read-only and shared among all users 
executing the file. This involves moving the data 
areas up to the first possible 4K word boundary 
following the end of the text. 

-i When the output file is executed, the program text and 
data areas will live in separate address spaces. The 
only difference between this option and -n is that here 
the data starts at location 0. 

-O The name argument after -o is used as the name of the 
Id output file, instead of a.out. 

-« The following argument is taken to be the name of the 
entry point of the loaded tirogram; location 0 is the 
default. 

-0 This is an overlay file, only the text segment will toe 
replaced by exec (2). Shared data must have the same 
layout as in the program overlaid. 

-D The next argument is a decimal number that sets the 
size of the data segment. 

FILES 
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( 1 ) 


/lib/lib*.a libraries 

/usr/lib/lib*.a more libraries 
a.out. output file 

SEE ALSO 

as(l), ar(l), cc(l), ranlib(l) 


BUGS 
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NAME 

ld86 - loader for the Intel iAPX86 
SYNOPSIS 

ld86 C option ] file ... 

DESCRIPTION 

Ld86 combines several object programs into one, resolves 
external references, and searches libraries. In the 
simplest case several object files are given, and ld68 
combines them, producing an objetJt module which can be 
either executed or become the input for a further ld86 run. 
(in the latter case, the -r option must be given to preserve 
the relocation bits.) The output of ld8 6 is left on b.out. 

The argument routines are concatenated in the order 
specified. The entry point of the output is the beginning 
of the first routine. 

If any argument is a library, it is searched exactly once at 
the point it is encountered in the argument list. Only 
those routines defining an unresolved external reference are 
loaded. If a routine from a library references another 
routine in the library, the referenced routine must appear 
after the referencing routixie in the library. Thus the 
order of programs v/ithin libraries may be important. 

The symbols '_etext', '_edata' and '_end' ('etext', 'edata' 
and 'end' in C) are reserved, and if referred to, are set to 
the first location above the program, the first location 
above initialized data, and the first location above all 
data respectively. It is erroneous.to define these symbols. 

Ld86 understands several options. Except for -1, they 
should appear before the file names. 

-s 'strip' the output, that is, remove the symbol table 
and relocation bits to save space (but impair the 
usefulness of the debugger). 

-u Take the following argument as a symbol and enter it as 
undefined in the symbol table. This is useful for 
loading wholly from a library, since initially the 
symbol table is empty and an unresolved reference is 
needed to force the loading of the first routine. 

-Ijc This option is an abbreviation for the library name 

'/usr/lib/861ib2C.a*, where x is a string. If that does 
not exist, ld36 tries '/lib7861ibx.a'. A library is 
searched when its name is encountered, so the placement 
of a -1 is significant. 
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-X 


-X 


Do not preserve local (non-.globl) 
output symbol table; only enter extl 
option saves some space in the outp 


Save local symbols except for thosel 

with '.L'. This option is used by _ 

internally generated labels while rjetaining symbols 
local to routines. 


-r 


-d 


-n 


-o 


-T 


Generate relocation bits in the out] 
can be the subject of another ld86 
prevents final definitions from bei 
symbols# and suppresses the 'undefi 
diagnostics. 

Force definition of common storage 
is present. 

Arrange that when the output file : 
portion will be read-only and shar^ 
executing the file. 

The name argument after -o is used 
ld86 output file, instead of b.out. 


LD86 


symbols in the 
|ernal symbols, 
ut file. 


This 


whose names begin 
cc86(l) to discard 


Iput file so that it 
run. This flag also 
ng given to common 
ned symbol * 


even if the -r fl 


ag 


s executed, the tpxt 
d among all users 


as the name of the 


The next argument is a hex number giving the address 
which the program is to be loaded into iSBC86/12 
memory. A value of 400 is typically used to load thj 
program above reserved low memory data areas. 


FILES 


/lib/861ib*.a libraries 

/usr/lib/861ib*.a more libraries 
b.out output file 

SEE ALSO 

a86(l), ar(l), cc86(l) 

BUGS 
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NAME 

lex - generator of lexical analysis prograuas 
SYNOPSIS 

lex C -tvfn ] C file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analyis 
of text. The input files (standard input default) contain 
regular expressions to be searched for, and actions written 
in C to be executed when expressions are found. 

A C source program, 'lex.yy.c' is generated, to be compiled 
thus: 

cc lex.yy.c -11 

This program, when run, copies unrecognized portions of the 
input to the output, and executes the associated C action 
for each regular expression that is recognized. 

The following lex program converts upper case to lower, 
removes blanks at the end of lines, and replaces multiple 
blanks by single blanks. 


%% 

Ca-Z] putchar(yytextC0]+'a'-'A'); 

C ]+$ 

C ]+ putchar(' '); 

The options have the following meanings. 

-t Place the result on the standard output instead of in 
file 'lex.yy.c'. 

-V Print a one-line summary of statistics of the generated 
analyzer. 

-n Opposite of -v; -n is default. 

-f 'Faster' compilation; don't bother to pack the 
resulting tables; limited to small programs. 

SEE ALSO 

yacc(1) 

M. E. Lesk and E. Schmidt, LEX - Lexical AnaWzer Generator 
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NAME 

Ifnt - load font 
SYNOPSIS 

Ifnt E fontnum ] E fontname ] E window ] 


DESCRIPTION 

Lfnt loads the font in file fontname inti 


o window window a| 
not supplied/ Tt 
e must be a complj 

_ be ill the range 

is the default font and is autonjatically loaded) . 


assigns it number fontnum * If window is 
defaults to the current window. Fontnan^' 
pathname of the font file, 
to G (7 


Fontnum must 


nd 

ete 

0 


FILES 

/Fonts/CRT contains available fonts. 
SEE ALSO 

Isfnt(l) sfnt(l) cfnt(l) 
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NAME 

lint - a C program checker 
SYNOPSIS 

lint C -abchnpuvx ] file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files 
which are likely to be bugs, non-portable, or wasteful. It 
also checks type usage more strictly than the compilers. 
Among the things which are currently detected are 
unreachable statements, loops not entered at the top, 
automatic variables declared and not used, and logical 
expressions whose value is constant. Moreover, the usage of 
functions is checked to find functions which return values 
in some places and not in others, functions called with 
varying numbers of arguments, and functions whose values are 
not used. 

It is assumed that all the files are to be loaded together; 
they are checked for mutual compatibility. By default, lint 
uses function definitions from the standard lint library 
llib-lc.ln; function definitions from the portable lint 
library llib-port.ln are used when lint is invoked with the 
-p option. 

Any number of lint options may be used, in any order. The 
following options are used to ..suppress certain kinds of 
complaints: 

-a Suppress complaints about assignments of long values to 
variables that are not long. 

-b Suppress complaints about break statements that cannot 
be reached. (Programs produced by lex or yacc will 
often result in a large number of such complaints.) 

-c Suppress complaints about casts that have questionable 
portability. 

-h Do not apply heuristic tests that attempt to intuit 
bugs, improve style, and reduce waste. 

-u Suppress complaints about functions and external 

variables used and not defined, or defined and not 
used. (This option is suitable for running lint on a 
subset of files of a larger program.) 

-V Suppress complaints about unused arguments in 
functions. 

-x Do not report variables referred to by external 


Page 1 


(printed 8/22/83) 



LINT(l) Nu Machine UNIX Programmer's I^anual 

declarations but never used. 

The following arguments alter lint 's behavior: 

-n 


Do not check compatibility against 
or the portable lint library. 


either the standard 


-P 


Attempt to check portability to othjer dialects (IBM ^nd 
GCOS) of C. 


The -D, -U, and -I options of cc(l) are ^Iso recognized ai^ 
separate arguments. 


Certain conventional comments in the C s 
the behavior of lint: 


puree will change 


/*NOTREACHED*/ 

at appropriate points stops coijmnents about 
unreachable code. 


/♦VARARGSn*/ 

suppresses the usual checking 
of arguments in the following 
declaration. The data types o£ 
arguments are checked; a missin 

0 . 


for variable numbe 
unction 
the first n 
g n is taken to l|>e 


/♦ARGSUSED*/ 

turns on the -v option for the 
/*LINTLIBRARY*/ 

at the beginning of a file shut 
about unused functions in this 


Lint produces its first output on a per 
Complaints regarding included files are 
printed after all source files have been 
Finally, information gathered from all i 
collected and checked for consistency, 
is not clear whether a complaint stems 
file or from one of its included files, 
will be printed followed by a question m 




PILES 


/ usr/lib/lintCl2.] 
/usr/lib/llib-lc.In 


/usr/lib/llib-port.In 


/usr/tmp/*lint* 


so 


programs 

declarations for 
(binary format; 
/usr/lib/llib-lc) 
declarations for 
(binary format; s 
/usr/lib/11ib-por4 
temporaries 
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file. 


source file basisJ 
oollected and 
processed, 
rjiput files is 

this point, if 
om a given soured 
the source file name 
ark. 


At 


rs 


it 


standard functions! 
urce is in 


portable functions] 
puree is in 
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SEE ALSO 

cc(l). 

BUGS 

Exit(2) and other functions which do not return are not 
understood; this causes various lies. 
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NAME 


In “ make a link 


SYNOPSIS 

In namel C name2 ] 

DESCRIPTION 

A link is a directory entry referring to 
file (together with its size, all its pr' 
information, etc.) may have several link 
no way to distinguish a link to a file f 
directory entry; any changes in the file 
independently of the name by which the f 


a file; the same 
btection 

s to it. There i^ 
fom its original' 
are effective 
lie is known. 


Ln creates a link to an existing file najnel ♦ If name2 is 
given, the link has that name; otherwise 
current directory and its name is the la 
name1. 


it is placed in 
kt component of 


It is forbidden to link to a directory o}r to link across 
file systems. 


SEE ALSO 

rm(l) 
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NAME 

login - sign on 
SYNOPSIS 

login [ username ] 

DESCRIPTION 

The login command is used when a user initially signs on, or 
it may be used at any time to change from one user to 
another. The latter case is the one summarized above and 
described here. See 'How to Get Started' for how to dial up 
initially. 

If login is invoked without an argument, it asks for a user 
name, and, if appropriate, a password. Echoing is turned 
off (if possible) during the typing of the password, so it 
will not appear on the written record of the session. 

After a successful login, accounting files are updated and 
the user is informed of the existence of . mail and message- 
of“the-day files. Login initializes the user and group IDs 
and the working directory, then executes a command 
interpreter (usually ^(1)) according to specifications 
found in a password file. Argument 0 of the command 
interpreter is '-sh. 

Login is recognized by ^(1) and executed directly (without 
forking). 

FILES 

/etc/utmp 
/usr/adm/wtmp 
/usr/mail/* 

/etc/raotd 
/etc/passwd 

SEE ALSO 

init(8), newgrp(l), getty(8), mail(l), passwd(l), passwd(5) 
DIAGNOSTICS 

^Login incorrect,' if the name or the password is bad. 

'No Shell', 'cannot open password file', 'no directory'; 
consult a programming counselor. 


accounting 

accounting 

mail 

message-of-the-day 
password file 
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NAME 

Ipr - line printer spooler 
SYNOPSIS 

Ipr C option ... ] C name ... ] 


DESCRIPTION 

Lpr causes the named files to be queued for printing on a 
line printer. If no names appear, the standard input is 
assumed; thus lpr may be used as a filter. 


The following options may be given (each as a separate 
argument and in any order) before any file name arguments: 


-c 


-r 


Makes a copy of the file to be sen 
to the user. 

Removes the file after sending it. 


t before 


returnid 


5 


FILES 

/etc/passwd 

/usr/lib/lpd 
/usr/spool/Ipd/* 


user's identification 
data. 

line printer daemon, 
spool area. 


and accounting 
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NAME 

Is - list contents of directory 
SYNOPSIS 

Is C -abcdfgilmqrstuxlCFR ] name ... 

1 C 1^ options ] name ... 

DESCRIPTION 

For each directory arguinent, lists the contents of the 
directory; for each file argument, ^ repeats its name and 
any other information requested. The output is sorted 
alphabetically by default. When no argument is given, the 
current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but 
file arguments appear before directories and their contents. 

There are three major listing formats. The format chosen 
depends on whether the output is going to a teletype, and 
may also be controlled by option flags. The default format 
for a teletype is to list the contents of directories in 
multi-column format, with the entries sorted down the 
columns. (Files which are not the contents of a directory 
being interpreted are always sorted across the page rather 
than down the page in columns. This is because the 
individual file names may be arbitrarily long.) If the 
standard output is not a teletype, the default format is to 
list one entry per line. Finally, there is a stream outtaut 
format in which files are listed across the page, separated 
by ,' characters. The -m flag enables this format; when 
invoked as ^ this format is also used. 

There are an unbelievable number of options; 

-1 List in long format, giving mode, number of links, 

owner, size in bytes, and time of last modification for 
each file. (See below.) If the file is a special file 
the size field will instead contain the major and minor 
device numbers. 

-t Sort by time modified (latest first) instead of by 
name, as is normal. 

—a List all entries; usually '.* and ' are suppressed. 

-s Give size in blocks, including indirect blocks, for 
each entry. 

-d If argument is a directory, list only its name, not its 
contents (mostly used with -1 to get status on 
directory). 

-r Reverse the order of sort to get reverse alphabetic or 
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oldest first as appropriate. 

Use time of last access instead of l^st modification 
for sorting (-t) or printing (-1). 


Use time of file creation for sortin 

Print i-number in first column of th 
file listed. 

Force each argument to be interprete 
and list the name found in each slot 
turns off -1, -t, -s, and -r, and tu 
order is the order in which entries 
directory. 

Give group ID instead of owner ID in 

force stream output format 

force one entry per line output formj 
teletype 

force multi-column output, e.g. to a 

force printing of non-graphic charac 
as the character this normally 

output device is a teletype 


force printing of non-graphic characters to be in the 
\ddd notation, in octal. 


force columnar printing to be sorted 
down the page; this is the default i 
character of the name the program is 

'x'. 

cause directories to be marked with 
executable files to be marked with a 
is the default if the last character 
program is invoked with is a 'f*. 


-R recursively list subdirectories encountered 


The mode printed under the -1 option conta 
which are interpreted as follows; the firs 


d 

b 

c 

m 
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fi 


if the entry is a directory; 
if the entry is a block-type special 
if the entry is a character-type speci 
if the entry is a multiplexor-type chai- 
file; 


b or printing, 
e report for each 


p as a directory 
. This option 
Irns on -a; the 
appear in the 


long listing. 


at, e.g. to a 


file or a pipe 

j:ers in file names 
happens only if the 


n 


across rather tha 
f the last 
invoked with is in 


L trailing '/' and 
trailing thp 
of the name the 


dns 11 characters 
it character is 


le; 

pi file; 
acter special 
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- if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three 
bits each. The first set refers to owner permissions; the 
next to permissions to others in the same user-group; and 
the last to all others. Within each set the three 
characters indicate permission respectively to read, to 
write, or to execute the file as a program. For a 
directory, 'execute' permission is interpreted to mean 
permission to search the directory for a specified file. 

The permissions are indicated as follows: 

r if the file is readable; 
w if the file is writable; 

X if the file is executable; 

- if the indicated permission is not granted. 

The group-execute permission character is given as s if the 
file has set-group-ID mode; likewise the user-execute 
permission character is given as s if the file has set- 
user-ID mode. 

The last character of the mode (normally 'x* or '-') is t if 
the 1000 bit of the mode is on. See chmod (1) for the 
meaning of this mode. 

T'Oien the sizes of the files in a directory are listed, a 
total count of blocks, including indirect blocks is printed. 

FILES 

/etc/passwd to get user ID's for 'is -1'. 

/etc/group to get group ID's for 'Is -g'. 

BUGS 

Newline and tab are considered printing characters in file 
names. 

The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype 
is undesirable as "is -s'' is much different than 
''is -s I Ipr''. On the other hand, not doing this setting 
would make old shell scripts which used almost certain 
losers. 

Column widths choices are poor for terminals which can tab. 
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NAME 


Isfnt - list loaded fonts 


SYNOPSIS 

Isfnt 

DESCRIPTION 

Lsfnt Displays a list of all loaded fontls 
The font number is listed (* next to the 
selected) along with the pathname of the 
pathname is displayed in its own font ty| 


for the window, 
font currently 
loaded font. The 
pe. 


SEE ALSO 

Ifnt(l) sfntd) cfnt(l) 


( 1 ) 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 C files ] 

DESCRIPTION 

^ is a macro processor intended as a front end for Ratfor, 
C, and other languages. Each of the argument files is 
processed in-order? if there are no arguments, or if an 
argument is the standard input is read. The processed 

text is written on the standard output. 

Macro calls have the form 

name(argl,arg2, . . . , argn) 

The (* must immediately.follow the name of the macro. If a 
defined macro name is not followed by a '(', it is deemed to 
have no arguments. Leading unquoted blanks, tabs, and 
newlines are ignored while collecting arguments. Potential 
macro names consist of alphabetic letters, digits, and 
underscore , where the first character is not a digit. 

Left and right single quotes ('*) are used to quote strings. 
The value of a quoted string is the string stripped of the 
quotes. 

When a macro name is recognized, its arguments are collected 
by searching for a matching right parenthesis. Macro 
evaluation proceeds normally during the collection of the 
arguments, and any coramas or right parentheses which happen 
to turn up within the value of a nested call are as 
effective as those in the original input text. After 
argument collection, the value of the macro is pushed back 
onto the input stream and rescanned. 


^ makes available the following built-in macros. They may 
be redefined, but once this is done the original meaning is 
lost. Their values are null unless otherwise stated. 


define The second argument is installed as the value of 
the macro whose name is the first argument. Each 
occurrence of $n in the replacement text, where n 
is a digit, is replaced by the n-th argument. ~ 
Argument 0 is the name of the macro; missing 
arguments are replaced by the null string. 

undefine removes the definition of the macro named in its 
argument. 


ifdef 


If the first argument is defined, the value is the 
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Page 


second argument, otherwise the third. If there 
no third argument, the value is null. The word 
Unix is predefined on UNIX versions of m4 . 


changequote 

Change quote characters to the 
arguments. Changequote withou|t 
the original values (i.e., '*) 


divert ^ maintains 10 output streams 
final output is the concatenatji 
in numerical order; initially 
current stream. The divert ma 
current output stream to its 
argument. Output diverted to 
0 through 9 is discarded. 


numbered 0-9. 
ion of the stream^ 
stream 0 is the 
cro changes the 
(digit-string) 
a stream other thiin 


undivert causes immediate output of tex 
named as arguments, or all divjs 
argument. Text may be undiver 
diversion. Undiverting discar 

text r 


it from diversions 
rsions if no 
ted into another 
ds the diverted 


divnum 

dnl 

ifelse 


returns the value of the current outiJut stream. 

Lp to and includih 


reads and discards characters 
the next newline. 


has three or more arguments, 
argument is the same string as 
the value is the third argumenit 
there are more than four argum< 
repeated with arguments 4, 5, 
the value is either the fourth 
is not present, null. 


incr 


returns the value of its argum' 
1. The value of the argument 
interpreting an initial digit- 
number . 


eval 

len 

index 


evaluates its argument as an a 
expression, using 32-bit arithi 
include +, -, *, /, %, (expo: 
relationals; parentheses. 

returns the number of characte 

returns the position in its fi 
the second argument begins (ze 
the second argument does not o 


first and second 
arguments restot 


es 


The 


If the first 
the second, then 
If not, and i 
bnts, the process is 
6 and 7. Otherwise, 
string, or, if ii 


pnt incremented by 
is calculated by 
string as a decim4 


rithmetic 
metic. Operators 
nentiation); 


rs in its argumenii 

rst argument where 
ro origin), or -1 
ccur. 
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substr returns a substring of its first argument. The 

second argument is a zero origin number selecting 
the first character; the third argument indicates 
the length of the substring. A missing third 
argument is taken to be large enough to extend to 
the end of the first string. 

translit transliterates the characters in its first 

argument from the set given by the second argument 
to the set given by the third. No abbreviations 
are permitted. 

include returns the contents of the file named in the 
argument. 

sinclude is identical to include , except that it says 
nothing if the file is inaccessible. 

syscmd executes the UNIX command given in the first 
argument. No value is returned. 

maketemp fills in a string of XXXXX in its argument with 
the current process id. 

errprint prints its argument on the diagnostic output file. 

dumpdef prints current names and definitions, for the 

named items, or for all if no arguments are given. 

SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The M4 Macro Processor 
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NAME 


mail - send or receive mail among users 


th 

If 


SYNOPSIS 

mail person ... 

mail C -r 3 C -q 3 C -p 3 [ -f file 3 

DESCRIPTION 

Mail with no argument prints a user s 
message, in last-in, first-out order; 

—r causes first—in, first—out order• 
given, the mail is printed with no ques 
otherwise, for each message, mail reads 
standard input to direct disposition of 

newline 

Go on to next message, 
d Delete message and go on to the ne^ct. 
p Print message again. 

Go back to previous message. 

s C file 3 • • • , ,1 , 

Save the message in the named rile 


,il, message-by- 
e optional argumejnt 
the -p flag is 
ittions asked; 
a line from the 
the message. 


k ('mbox* default) 


w C file 3 ♦•• 

Save the message, without a header 
('mbox' default). 

m C person 3 ••• 

Mail the message to the named pers 
default). 

EOT (control-D) 

Put unexamined mail back in the raa 


q Same as EOT. 

X Exit, without changing the mailbox| file. 

Icommand 

Escape to the Shell to do command. 

? Print a command summary. 


An interrupt stops the printing of the 
optional argument —q causes mail to ex 
without changing the mailbox. 

When persons are named, mail takes the 


MAIL 


( 1 ) 


, in the named files 


Ions (yourself is 


ilbox and stop. 


current letter 
it after interrupt! 


standard input up 


The 

s 


to 
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an end-of-file (or a line with just '.') and adds it to each 
person 's 'mail' file. The message is preceded by the 
sender's name and a postmark. Lines that look like 
postmarks are prepended with '>'. A person is usually a 
user name recognized by login (l). To denote a recipient on 
a remote system, prefix person by the system name and 
exclamation mark (see uucp (1)). 

The -f option causes the named file, e.g. 'mbox', to be 
printed as if it were the mail file. 

Each user owns his own mailbox, which is by default 
generally readable but not writable. The command does not 
delete an empty mailbox nor change its mode, so a user may 
make it unreadable if desired. 

Vflien a user logs in he is informed of the presence of mail. 


PILES 

/usr/spool/mail/* mailboxes 

/etc/passwd to identify sender and locate persons 

mbox saved mail 

/tmp/ma* temp file 

dead.letter unmailable text 

uux(1) 


SEE ALSO 

xsend(l), write(1), uucp(l) 


BUGS 

There is a locking mechanism intended to prevent two senders 
from accessing the same mailbox, but it is not perfect and 
races are possible. 
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NAME 

make - maintain program groups 
SYNOPSIS 

make C -f makefile ] [ option ] ... file ... 

DESCRIPTION 

Make executes commands in makefile to update one or more 
target names . Name is typically a prograun. If no -f option 
is present/ 'makefile' and 'Makefile' are tried in order. 

If makefile is the standard input is taken. More than 

one -f option may appear 

Make updates a target if it depends on prerequisite files 
that have been modified since the target was last modifies, 
or if the target does not exist. 

Makefile contains a sequence of entries that specify 
dependencies. The first line of an entry is a blank- 
separated list of targets, then a colon, then a list of 
prerequisite files. Text following a semicolon, and all 
following lines that begin with a tab, are shell commands to 
be executed to update the target. 

Sharp and newline surround comments. 

The following makefile says that 'pgm' depends on two files 
'a.o' and 'b.o‘, and that they in turn depend on '.c' files 
and a common file 'incl*. 

pgm: a.o b.o 

cc a.o b.o -Im -o pgm 

a. o: incl a.c 

cc -c a.c 

b. o: incl b,c 

cc -c b.c 

Makefile entries of the form 
stringl = string2 

are macro definitions. Subsequent appearances of $( stringl ) 
are replaced by strlng2 . If stringl is a single character, 
the parentheses are optional. 

Make infers prerequisites for files for which makefile gives 
no construction commands. For example, a '.c' file may be 
inferred as prerequisite for a '.o' file and be compiled to 
produce the .o' file. Thus the preceding example can be 
done more briefly: 

pgm: a.o b.o 
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cc a.o b.o -Im -o pgra 
a.o b.o: incl 

Prerequisites are inferred according to selected suffixes 
listed as the 'prerequisites' for the special neirae 
'.SUFFIXES'; multiple lists accumulate; an empty list clears 
what came before. Order is significant; the first possible 
name for which both a file and a rule as described in the 
next paragraph exist is inferred. The default list is 

.SUFFIXES: .out .o .c .e .r .f .y .1 .s 

The rule to create a file with suffix £2 that depends on a 
similarly named file with suffix sl^ is specified as an entry 
for the 'target' sls2 . In such an entry, the special macro 
$* stands for the target name with suffix deleted, $@ for 
the full target name, $< for the complete list of 
prerequisites, and $? for the list of prerequisites that are 
out of date. For example, a rule for making optimized '.o' 
files from '.c' files is 

.c.o: ; cc -c -O -o $@ $*.c 

Certain macros are used by the default inference rules to 
communicate optional arguments to any resulting 
compilations. In particular, 'CFLAGS' is used for cc and 
f77 (1) options, 'LFLAGS' and 'YFLAGS' for lex and yacc (l) 
options. 

Command lines are executed one at a time, each by its own 
shell. A line is printed when it is executed unless the 
special target '.SILENT' is in makefile , or the first 
character of the command is '@'. 

Commands returning nonzero status (see intro (1)) cause make 
to terminate unless the special target '.IGNORE' is in 
makefile or the coromand begins with <tab><hyphen>. 

Interrupt and quit cause the target to be deleted unless the 
,target depends on the special name '.PRECIOUS'. 

Other options: 

-i Equivalent to the special entry '.IGNORE:'. 

-k ^^^hen a command returns nonzero status, abandon work on 
the current entry, but continue on branches that do not 
depend on the current entry. 

-n Trace and print, but do not execute the commands needed 
to update the targets. 
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-t Touch, i.e. update the modified date of targets, 
without executing any commands. 

-r Equivalent to an initial special entry '.SUFFIXES:' 
with no list. 


-s 


Equivalent to the special entry '.S 


ILENT:'. 


FILES 

makefile. Makefile 


SEE ALSO 

sh(1), touch{1) 

S. I. Feldman Make - A Program for Maint 
Programs 


aininq Computer 


BUGS 


Some commands return nonzero status inappropriately. Use 
to overcome the difficulty. T 

Commands that are directly executed by the shell, notably 
cd(l), are ineffectual across newlines in make. 


-X 
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NAME 

makeXey - generate encryption key 
SYNOPSIS 

/usr/lib/makekey 

DESCRIPTION 

Makekey improves the usefulness of encryption schemes 
depending on a key by increasing the amount of time required 
to search the key space. It reads 10 bytes from its 
standard input, and writes 13 bytes on its standard output. 
The output depends on the input in a way intended to be 
difficult to compute (i.e., to require a substantial 
fraction of a second). 

The first eight input bytes (the input key) can be arbitrary 
ASCII characters. The last two (the salt ) are best chosen 
from the set of digits, ., /, and upper- and lower-case 
letters. The salt characters are repeated as the first two 
characters of the output. The remaining 11 output 
characters are chosen from the same set as the salt and 
constitute the output key . 

The transformation performed is essentially the following: 
the salt is used to select one of 4,096 cryptographic 
machines all based on the National Bureau of Standards DES 
algorithm, but broken in 4,096 different ways. Using the 
input key as key, a constant string is fed into the machine 
and recirculated a number of times. The 64 bits that come 
out are distributed into the 66 output key bits in the 
result. 

Makekey is intended for programs that perform encryption 
(e.g., ed(1) and crypt (1)). Usually, its input and output 
will be pipes. 

SEE ALSO 

crypt(l), ed(l), passwd(4). 
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NAME 


man ~ find manual information by keywords; print out the 
manual ~ 


SYNOPSIS 

man -k keyword ... 
man —f file ... 

man [ - ] C -t ] C section ] title ... 
DESCRIPTION 

Man is a program which gives information 
programmers manual. It can be asked for 
descriptions of commands specified by na 
commands whose description contains any 
keywords. It can also provide on-line a 
sections of the printed manual. 

When given the option -k and a set of ke 
out a one line synopsis of each manual s^ 
listing in the table of contents contains 


m 


When given the option -f and a list of fi 
attempts to locate manual sections relats 
printing out the table of contents lines 


T'Jhen neither -k nor -f is specified, man 
set of manual pages. If a section speci 
looks in the that section of the manual 
titles . Section is an arable section numb 
may be followed by a single letter class! 
indicating a graphics program in section 
omitted, man searches all sections of th^ 
preference to commands over subroutines 
and printing the first section it finds. 


if the flag - is 
cat(l) with the 


If the standard output is a teletype, or 

given, then m^ pipes its output through ... , 

option —s to crush out useless blank lines, ul (1) to create 
proper underlines for different terminal^, and through 
more (1) to stop after each page on the sdreen. Hit a spaed 
to continue, a control—D to scroll 11 mocje lines when the 
output stops. 


MAN(l) 


from the 
one line 
me, or for all 
of a set of 
ccess to the 


ywords, man print^ 
Actions whose 
that keyword. 


le names, man 
d to those filesJ 
for those section 


formats a specified 
fier is given man 
^or the given 
er, i.e. 3, whicli 
fier, i.e. Ig 
1. If section is| 
manual, giving 
system librariejs, 
if any. 


in 


The -t flag causes man to arrange for the 
to be txoff'ed to a suitable raster outpu 
vtroff(1). 


specified sectioh 
t device; see 


FILES 

/usr/man/man?/* 
/usr/nan/cat?/* 

SEE ALSO 
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more(l)/ ul(l), whereis(l), catman(8) 


BUGS 

The manual is supposed to be reproducible either on the 
phototypesetter or on a typewriter. However, on a 
typewriter some information is necessarily lost. 
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NAME 

mesg - permit or deny messages 
SYNOPSIS 

mesg C n ] C y ] 


DESCRIPTION 

Mesg with argvunent n forbids messages vi 
revoking non-user write permission on th 
Mesg with argument y reinstates permissi 
mesg reports the current state without 


a write (1) by 
e user's terminal| 
on. All by itself, 
changing.it. 


FILES 

/dev/tty* 

/dev 

SEE ALSO 

write(1) 


DIAGNOSTICS 

Exit status is 0 if 
error. 


messages are receivablSi 1 


if not, 2 on 
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NAME 

mkdir - make a directory 
SYNOPSIS- 

mkdir dirneune ... 

DESCRIPTION 

Mkdir creates specified directories in mode 777. Standard 
entries, for the directory itself, and '..* for its 

parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rra{l) 

DIAGNOSTICS 

Mkdir returns exit code 0 if all directories were 
successfully made. Otherwise it prints a diagnostic and 
returns nonzero. 
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NAME 

mkfa - construct a Eile system 
SYNOPSIS 

/etc/mk£s special proto 
DESCRIPTION 

Mkfs constructs a file system by writing c}n the special filje 
special according to the directions found 
file proto » The prototype file contains tOkens separated by 
spaces or new lines. The first token is the name of a file 
to be copied onto block zero as the bootstrap program, see 
bproc (8). The second token is a number specifying the size] 
of the created file system. Typically it 
of blocks on the device, perhaps diminish 
swapping. The next token is the number o 
i-list. The next set of tokens comprise 
for the root file. File specifications c 
giving the mode, the user-id, the group i 
contents of the file. The syntax of the c 
depends on the mode. 


MKFS(IM) 


will be the numbel 
^ by space for 
i-nodes in the 
dhe specification 
insist of tokens 
and the initial 
ontents field 


The mode token for a file is a 6 character! 
first character specifies the type of the 
characters -bed specify regular, block spej 
special and directory files respectively. )| 
character of the type is either u or - to 
id mode or not. The third is g or - for t 
mode. The rest of the mode is a three dig 
giving the owner, group, and other read, 
permissions, see chmod(l). 


string. The 
file. (The 
cial, character 
The second 
specify set-user- 
jhe set-group-id 
it octal number 
ite, execute 


wr 


Two decimal number tokens come after the m 
the user and group ID's of the owner of tn 


If the file is a regular file, the next tojken is a pathname 
whence the contents and size are copied. 


|ode; they specify 
e file. 


If the file is a block or character specia 
decimal number tokens follow which give tli| 
device numbers. 

If the file is a directory, mkfs makes the 
and then reads a list of names and (recurs 
specifications for the entries in the dire 
is terminated with the token $. 

If the prototype file cannot be opened and| 
of a string of digits, mkfs builds a file 
single empty directory on it. The size of 
is the value of proto interpreted as a dec 
number of i-nodes is calculated as a funct 


1 file, two 
e major and minor 


entries . and , 
ively) file 
ctory. The scan 


its name consist 
jsystera with a 
the file system 
imal number. The 
ion of the 
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filsystem size. The boot program is left uninitialized. 

A scunple prototype specification follows: 

/usr/mdec/uboot 
4872 55 
d—777 3 1 
usr d—777 3 1 

sh 755 3 1 /bin/sh 

ken d—755 6 1 

$ 

b0 b—644 3100 

c0 c—644 3100 

$ 


SEE ALSO 

filsys(5), dir(5), bproc(3) 

BUGS 

There should be some way to specify links. 
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mknod - build special file 
SYNOPSIS 

/etc/itiknod name C c 3 C b 3 major minor 
DESCRIPTION 

Mknod makes a special file. The first 
of the entry. The second is b if the s; 
block-type (disks, tape) or c if it is 
devices). The last two arguments are ni 
major device type and the minor device 
line number). 


The assignment of major device numbers is specific to each 


MKNOD(IM) 


jirgument is the name 
pecial file is 
c:haracter-type (otlher 
lumbers specifying the 
e.g. unit, drive, or 


system, 
conf.c. 


They have to be dug out of the 


system source file 


SEE ALSO 

mknod(2) 
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NAME 

mkstr — create an error message file by massaging C source 
SYNOPSIS 

ndcstr C - ] messagefile prefix file .. . 

DESCRIPTION 

Mkstr is used to create files of error messages. Its use 
can make programs with large numbers of error diagnostics 
much smaller, and reduce system overhead in running the 
program as the error messages do not have to be constantly 
swapped in and out. 

Mkstr will process each of the specified files , placing a 
massaged version of the input file in a file whose name 
consists of the specified prefix and the original name. A 
typical usage of mkstr would be 

mkstr pistrings xx *.c 

This command would cause all the error messages from the C 
source files in the current directory to be placed in the 
file pistrings and processed copies of the source for these 
files to be placed in files whose names are prefixed with 

XX . 

To process the error messages in the source to the message 
file mkstr keys on the string 'errorC" in the input stream. 
Each time it occurs, the C string starting at the is 
placed in the message file followed by a null character and 
a new-line character; the null character terminates the 
message so it can be easily used when retrieved, the new- 
line character makes it possible to sensibly cat the error 
message file to see its contents. The massaged copy of the 
input file then contains a Iseek pointer into the file which 
can be used to retrieve the message, i.e.; 


char efilnameC] = "/usr/lib/pi strings"; 
int efil = -1; 

error(al, a2, a3, a4) 

{ 

char bu£C256]; 

if (efil < 0) { 

efil = open(efilname, 0); 
if (efil < 0) { 

oops; 

perror(efilname); 
exit(1); 

} 
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} 


) 

if (lseek(efil, (long) al, 0) 
goto oops; 

printf(buf, a2, a3, a4); 


I I read(efll, bufl 


256) 


The optional - causes the error messages 
end of tlie specified message file for re 
large mTcstred program. 


to be placed at ihe 
Compiling part of 


SEE ALSO 

lseek(2), xstr(l) 


AUTHORS 

Bill Joy and Charles Haley 


BUGS 

All the arguments except the name of the 
processed are unnecessary. 


file to be 
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NAME 

more, page - file perusal filter for crt viewing 
SYNOPSIS 

more C -d ] C -f ] C -1 ] C -n 3 [ - Hinenumber ] C ^/ pattern 
3 [ name ... 3 

page C -d 3 C -f 3 C -1 3 C -n 3 C - Hinenumber 3 C ^/ pattern 
3 C name ... 3 

DESCRIPTION 

More is a filter which allows examination of a continuous 
text one screenful at a time on a soft-copy terminal. It 
normally pauses after each screenful, printing —More— at 
the bottom of the screen. If the user then types a carriage 
return, one more line is displayed. If the user hits a 
space, another screenful is displayed. Other possibilites 
are enumerated later. 

The command line options are: 

-n An integer which is the size (in lines) of the window 
which more will use instead of the default. 

-d More will prompt, the user with the message "Hit si^ace 
to continue, Rubout to abort" at the end of each 
screenful. This is useful if more is being used as a 
filter in some setting, such as a class, where many 
users may be unsophisticated. 

-f Tliis causes more to count logical, rather than screen 
lines. That is, long lines are not folded. This 
option is recommended if nroff output is being piped 
through ul , since the latter may generate escape 
sequences. These escape sequences contain characters 
which would ordinarily occupy screen postions, but 
which do not print when they are sent to the terminal 
as part of an escape sequence. Thus more may think 
that lines are longer than they actually are, and fold 
lines erroneously. 

-1 Do not treat (form feed) specially. If this option 
is not given, more will pause after any line that 
contains a '“L, as if the end of a screenful had been 
reached. Also, if a file begins with a form feed, the 
screen will be cleared before the file is printed. 

-t- linenumber 

Start up at linenumber . 

+/ pattern 

Start ui3 two lines before the line containing the 
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regular expression pattern . 


the screen is 


If the program is invoked as page , then 
cleared before each screenful is printed (but only if a ^ull 
screenful is being printed), and k - 1 rather than k - 2 
lines are printed in each screenful, vdi^re k is the number 
of lines the terminal can display. 


More looks in the file / etc / termcap to determine terminal 
characteristics, and to determine the default window siza. 
On a terminal capable of displaying 24 
window size is 22 lines. 


MOREd) 


ines, the default 


If more is reading from a file, rather than a pipe, then 
percentage is displayed along with the +--More— prompt. 
This gives the fraction of the file (in characters, not 
lines) that has been read so far. 

Other sequences which may be typed when more pauses, and 
their effects, are as follows (i^ is an optional integer 
argument, defaulting to 1) : 

^<space> 

display more lines, (or another Screenful if no 
argument is given) 


display 11 more lines (a "scroll''! 
then the scroll size is set to i* 

d same as '‘D (control-D) 

i^z same as typing a space except that 
becomes the new window size. 

i^s skip ^ lines and print a screenful 

if skip i screenfuls and print a screej 

q or Q 

Exit from more. 


V 

h 


Display the current line number. 

Start up the editor vi at the current line. 


). If i is given 


|i, if present, 

of lines 
Inful of lines 


Help command; give a description of 
commands. 


i/expr 

search for the i-th occurrence of"t|ie regular 
expression expr . If there are less than L occurrenc<^s 

input is a file (rather than a pipe 


all the more 
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-then the position in the file remains unchanged. 
Otherwise, a screenful is displayed, starting two lines 
before the place where the expression was found. The 
user’s erase and kill characters may be used to edit 
the regular expression. Erasing back past the first 
column cancels the search command. 

i^n search for the i^-th occurrence of the last regular 
expression entered. 

' (single quote) Go to the point from which the last 

search started. If no search has been performed in the 
current file, this command goes back to the beginning 
of the file. 

I command 

invoke a shell with command . The characters '%' and 'I' 
in "command" are replaced with the current file name 
and the previous shell command respectively. If there 
is no current file name, '%' is not expanded. The 
sequences "\%" and "\i" are replaced by "%" and "1" 
respectively. 

j^:n skip to the i^-th next file given in the command line 
(skips to last file if n doesn't make sense) 

i:p skip to the i-th previous file given in the conunand 
line. If this command is given in the middle of 
printing out a file, then more goes back to the 
beginning of the file. If i doesn't make sense, more 
skips back to the first file. If more is not reading 
from a file, the bell is rung and nothing else happens. 

;f display the current file name and line number. 

;q or ;Q 

exit from more (same as q or Q). 

. (dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not 
necessary to type a carriage return. Up to the time when 
the command character itself is given, the user may hit the 
line kill character to cancel the numerical argument being 
formed. In addition, the user may hit the erase character 
to redisplay the --More—(xx%) message. 

At any time when output is being sent to the terminal, the 
user can hit the quit key (normally control-\). More will 
stop sending output, and will display the usual —More— 
prompt. The user may then enter one of the above commands 
in the normal manner. Unfortunately, some output is lost 
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when this is done, due to the fact that 
waiting in the terminal's output queue 
quit signal occurs. 


any characters 
aire flushed when 


The terminal is set to noecho mode by thf 
the output can be continuous. What you 
show on your terminal, except for the / 


If the standard output is not a teletype 

just like cat , except that a header is pirinted befb^re eaclji 
file (if there is more than one). 

A sample usage of more in previewing nro:^f output would b«! 
nroff -ms +2 doc.n I more 


the 


s program so thai: 
type will thus no^ 
and 1 commands. 

then more acts 


AUTHOR 

Eric Shienbrood 

FILES 

/etc/termcap Teinninal data base 

/usr/lib/more.help Help file 

SEE ALSO 

scriptd) 


3) 
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NAME 

mount, umount - mount and dismount file system 
SYNOPSIS 

/etc/mount C special name C -r ] ] 

/etc/umount special 
DESCRIPTION 

Mount announces to the system that a removable file system 
is present on the device special « The file name must exist 
already; it must be a directory (unless the root of the 
mounted file system is not a directory). It becomes the 
name of the newly mounted root. The optional last argument 
indicates that the file system is to be mounted read-only. 

Umount announces to the system that the removable file 
system previously mounted on device special is to be 
removed. 

These commands maintain a table of mounted devices. If 
invoked without an argument, mount prints the table. 

Physically write-protected and magnetic tape file systems 
must be mounted read-only or errors will occur when access 
times are updated, whether or not any explicit write is 
attempted. 

FILES 

/etc/ratab: mount table 


SEE ALSO 

mount(2), mtab(5) 


BUGS 

Mounting file systems full of garbage will crash the system. 
Mounting a root directory on a non-directory makes some 
apparently good pathnames invalid. 
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NAME 

mv - move or rename files and directories 

SYNOPSIS 

mv filel file2 

mv file ... directory 

DESCRIPTION 

Mv moves (changes the name of) filel t<i file2, 


If file2 already exists, it is removed 
moved. If file2 has a mode which forbi 


the mode (see chmod (2)) and reads the 
obtain a line; if the line begins with 
place-; if not, mv exits. 


In the second form, one or more files 
directory with their original file-nam^ 

Mv refuses to move a file onto itself. 

SEE ALSO 

cp(1), chmod(2) 


BUGS 


MV(1) 


before filel is 


ds writing, mv prints 
Standard input to 
y, the move takes! 


are moved to the 

s. 


If filel and file2 lie on different fij 
copy the file and delete the original, 
owner name becomes that of the copying 


e systems, iw musi 
In this case thq 
process and any 


linking relationship with other files is lost. 

Mv should take -f flag, like rm, to suppress the questicfn if 
the target exists and is not writable. 
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NAME 

newgrp - log in to a new group 


SYNOPSIS 

newgrp group 


DESCRIPTION 

Newgrp changes the group identification of its caller, 
analogously to login (l)♦ The same person remains logged in, 
and the current directory is unchanged, but calculations of 
access permissions to files are performed with respect to 
the new group ID. 


A password is demanded if the group has a password and the 
user himself does not. 

When most users log in, they are members of the group named 
'other.’ Newgrp is known to the shell, which executes it 
directly without a fork. 


FILES 

/etc/group, /etc/passwd 
SEE ALSO 

login(l), group(5) 
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NAME 


nice, nohup - run a command at low prio 


SYNOPSIS 

nice C -number ] command [ arguments ] 
nohup command [ arguments ] 

DESCRIPTION 

Nice executes command with low scheduli 


NICEd) 


tity 


hg priority. If the 


number argument is present, the priority is incremented 
(higher numbers mean lower priorities) by that amount up 
a limit of 20. The default number is 10. 


The super-user may run commands with pr 
normal by using a negative priority, e. 


fority higher tharf 

10 ' . 


Nohup executes command immune to hangup 
signals from the controlling terminal, 
incremented by 5. Nohup should be invo! 
with in order to prevent it from re 
interrupts by or stealing the input froiji 
logs in on the same terminal. 


and terminate 
The priority is 
ilted from the shell! 
i^ponding to 

the next person Iwho 


to 


FILES 

nohup.out standard output and 
nohup 


standard 4rror file under 


SEE ALSO 

nice(2) 

DIAGNOSTICS 

Nice returns the exit status of the subject command, 
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NAME 

nm - print name list 
SYNOPSIS 

nm C -gnopru ] C file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file 
in the argument list. If an argument is an archive, a 
listing for each object file in the archive will be , 
produced. If no file is given, the symbols in 'a.out' are 
listed. 

Each symbol naune is preceded by its value (blanks if 
undefined) and one of the letters U (undefined), A 
(absolute), T (text segment symbol), D (data segment 
symbol), B (bss segment symbol), or C (common symbol). If 
the symbol is local (non-external) the type letter is in 
lower case. The output is sorted alphabetically. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output 
line rather than only once. 

-p Don't sort; print in symbol-table order. 

-r Sort in reverse order. 

-u Print only undefined symbols. 

SEE ALSO 

ar(l), ar(5), a.out(5) 
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NAME 


nm86 - print name list for b.out format files 


SYNOPSIS 

nm86 C -gnopru ] C file ... 3 
DESCRIPTION 

Nm86 prints the name list (symbol table 
format object file in the argument list 

object files are produced by aSG and cc^6, which produce 
code for the Intel iAPX86. 


Each symbol name is preceded by its value (blanks if 
undefined) and one of the letters U (un<^efined), A 
(absolute), T (text segment symbol), D 

symbol), B (bss segment symbol), or C (Common symbol). :|f 
the symbol is local (non-external) the type letter is in 
lower case. The output is sorted alphabetically. 


Options are; 

-g Print only global (external) symbols 

Sort numerically rather than alphabetically. 


-n 

-o 

-P 

-r 

-u 

-X 


Prepend file or archive element naipe to each output 
line rather than only once. 

Don't sort; print in symbol-table <j)rder. 

Sort in reverse order. 

Print only undefined symbols. 

Print values in hex instead of oct4l. 


NM86(1) 


of each b.out 
B.out format 


SEE ALSO 

ar(l), ar(5), b.out(5) 
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NAME 

nroff, troff - text formatting and typesetting 
SYNOPSIS 

nroff C option ] ... [ file ] ... 

DESCRIPTION 

Nroff formats text in the named files for typewriter-like 
devices. See also troff (1). The full capabilities of nroff 
and troff are described in the Nroff / Troff User * s Manual . 

If no file argument is present, the standard input is read. 
An argument consisting of a single minus (-) is taken to be 
a file name corresponding to the standard input. 

The options, which may appear in any order so long as they 
appear before the files, are; 

- olist Print only pages whose page numbers appear in the 

comma-separated list of numbers and ranges. A range 
N-M means pages N through M; an initial -N means from 
the beginning to page N; and a final N- means from N 
to the end. 

-nN Number first generated page N. 

-sN Stop every N pages. Nroff will halt prior to every N 
pages (default N=1) to allow paper loading or 
changing, and will resume upon receipt of a newline. 

- mnarae Prepend the macro file /usr/lib/tmac/tmac.name to the 
input files . 

-raN Set register a (one-character) to N. 

-i Read standard input after the input files are 
exhausted. 

-q Invoke the simultaneous input-output mode of the rd 
request. 


-T name Prepare output for specified terminal. Known names 
are 37 for the (default) Teletype Corporation Model 
37 terminal, tn300 for the GE TermiNet 300 (or any 
terminal without half-line capability), 300S for the 
DASI-300S, 300 for the DASI-300, and 450 for the 
DASI-450 (Diablo Hyterm). 

-e Produce equally-spaced words in adjusted lines, using 
full terminal resolution. 
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-h Use output tabs during horizontal spacing to speed 
output and reduce output character count. Tab 
settings are assumed to be every 8 nominal character 
widths. 


EXAMPLE 

nroff “s4 -me fllea 

will nroff the named file using the -me ^cro package, 
stopping every 4 pages. 

FILES 

/usr/lib/suftab suffix hyphenation tables 

/tmp/ta* temporary file 

/usr/lib/tmac/tmac.* standard macro files 
/usr/lib/term/* terminal driving tables for nroff 

SEE ALSO 

J. P. Ossanna, Nroff / Troff user 's manual 
B. W. Kernighan, A TROFF Tutorial 

troff(l), eqn(l), tbl(l), ms(7), me(7), man(7), col(l) 
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NAME 

od - octal dump 
SYNOPSIS 

Od C -bcdox ] C file 3 C C + ]offsetC . 3C b ] 3 
DESCRIPTION 

Od dumps file in one or more formats as selected by the 
first argument. If the first argument is missing, —o is 
default. The meanings of the format argument characters 
are: 

b Interpret bytes in octal. 

c Interpret bytes in ASCII. Certain non-graphic characters 
appear as C escapes: iiull=\0, bachspace=\b, formfeed=\f, 
newline=\n, return=\r, tab=\t 7 others appear as 3-digit 
octal numbers. 

d Interpret words in decimal, 

o Interpret words in octal. 

X Interpret words in hex. 

The file argument specifies which file is to be dumped. If 
no file argument is specified, the standard input is used. 

The offset argument specifies the offset in the file where 
dumping is to commence. This argument is normally 
interpreted as octal bytes. If .' is appended, the offset 
is interpreted in decimal. If 'b' is appended, the offset 
is interpreted in blocks of 512 bytes. If the file argument 
is omitted, the offset argument must be preceded '+'. 

Dumping continues until end-of-file. 

SEE ALSO 

adb(1) 
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NAME 

p - file perusal filter for crt viewing 

SEE 

more{1) 
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PAGE(l) 


NAME 

page “ file perusal filter for crt viewing 

SEE 

more{1) 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd C name ] 


DESCRIPTION 

This command changes (or installs) a pa 
with the user name (your own name by del 


The program prompts for the old passwort^ 
new one. The caller must supply both 
must be typed twice, to forestall mistak 


New passwords must be at least four chaip 
use a sufficiently rich alphabet and at 
long if monocase. These rules are rela 
insistent enough. 


ssword associated 
ault). 


and then for the 
The new password 
es. 


acters long if they 
least six characters 
ked if you are 


Only the owner of the neune or the super-user may change ^ 
password; the owner must prove he knows the old password 


FILES 

/etc/passwd 
SEE ALSO 

login(l), passwd(5), cryptO) 

Robert Morris and Ken Thompson, Password Security ; A Cas^ 
History 
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NAME 

paste - merge same lines of several files or subsequent 
lines of one file 

SYNOPSIS 
paste 
paste 
paste 

DESCRIPTION 

In the first two forms, paste concatenates corresponding 
lines of the given input files filel , file2 , etc. It treats 
each file as a column or columns of a table and pastes them 
together horizontally (parallel merging). If you will, it 
is the counterpart of cat (1) which concatenates vertically, 
i.e., one file after the other. In the last form above, 
paste subsumes the function of an older command with the 
Scime name by combining subsequent lines of the input file 
(serial merging). In all cases, lines are glued together 
with the tab character, or with characters from an 
optionally specified list . Output is to the standard 
output, so it can be used as the start of a pipe, or as a 
filter, if - is used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each 
but the last file (or last line in case of the -s 
option) are replaced by a tab character. This option 
allows replacing the tab character by one or more 
alternate characters (see below). 

list One or more characters immediately following -d replace 
the default tab as the line concatenation character. 

The list is used circularly, i. e. when exhausted, it 
is reused. In parallel merging (i. e. no -s option), 
the lines from the last file are always terminated with 
a new-line character, not from the list . The list may 
contain the special escape sequences: \n (new-line), \t 
(tab), \\ (backslash), and \0 (empty string, not a null 
character). Quoting may be necessary, if characters 
have special meaning to the shell (e.g. to get one 
backslash, use -d'' \\\\ " ). 

-s Merge subsequent lines rather than one from each input 
file. Use tab for concatenation, unless a list is 
specified with -d option. Regardless of the list , the 
very last character of the file is forced to be a new- 
line. 

- May be used in place of any file name, to read a line 
from the standard input. (There is no prompting). 


filel file2 ... 

-dlist filel file2 ... 

-s C-dlist] filel file2 ... 
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EXAMPLES 

Is I paste -d" " - 

list directory in one column 

Is 1 paste - - - - 

list directory in four columns 

paste -s -d"\t\n” file 

combine pairs of lines into lines 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr -t -m... works similarly, but creates extra 
blanks, tabs and new-lines for a nice page layout. 

DIAGNOSTICS 

line too long 

Output lines are restricted to 511 characters. 
too many files 

Except for -s option, no more than 12 input files 
may be specified. 
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NAME 

pmda - post-mortem dump analyzer 
SYNOPSIS 

^da C -cpkrlbf ] [ file ] C addr ] C length ] 

DESCRIPTION 

Pmda is used to read the contents of a file generated by the 
monitor post-mortem dump utility pmd. File contains the dump 
image (the file name defaults to pmdump if not specified). 

If the dump was output to tape, the tape must be first 
copied to a disk file using dd with a blocksize of 8k. Addr 
specifies the starting address with the addressing unit 
defined by the options (defaults to zero if not specified). 
Length is the number of bytes from the starting address to 
dump Tdefaults to 256 if not specified). 

h Display contents of dump file header. 

f The dump file is specified by the next parameter. 

c addr is a click number. 

p addr is a physical address. 

k addr is a kernel virtual address. 

r byte reverse the display. 

1 display values as longs (4 bytes). 

b display values as bytes. 

defaults: 

File is pmdump. Addr is absolute dump file offest in 
bytes if c, p, or k options are not specified. Values 
are displayed as words (2 bytes). 

SEE ALSO 

dd(l), pmd(l) in SDU user's manual 
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NAME 


pr - print file 


SYNOPSIS 

pr C option ] •.. [ file ] ... 

DESCRIPTION 

Pr produces a printed- listing of one or 


output is separated into pages headed by a date, the names of 


the file or a specified header, and the 


PK(1) 


more files. The 


page number. If 


there are no file arguments, gr prints its standard inpuij. 

Options apply to all following files but may be reset 

between files: 

-n Produce n-column output. 

+n Begin printing with page n. 

-h Take the next argument as a page header. 

-wn For purposes of multi-column output, take the widthjof 
the page to be n characters instead of the default 72. 

-In Take the length of the page to be lines instead oi 
the default 66. . 

-t Do not print the 5-line header or 4^e 5-line trailerj 
normally supplied for each page. 

-sc Separate columns by the single character c instead d 


by the appropriate amount of white 
is taken to be a tab. 


-m Print all files simultaneously, each in one column. 

Inter-terminal messages via write (1) are forbidden during 
£r. 


FILES 

/dev/tty? to suspend messages. 

SEE ALSO 

cat(1) 

DIAGNOSTICS 

There are no diagnostics when pr is pririting on a terminal 


space. A missing 
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NAME 

printenv - print out the environment 


SYNOPSIS 

printenv C name ] 


DESCRIPTION 

Printenv prints out the values of the variables in the 
environment. If a name is specified, only its value is 
printed. 


If a name is specified and it is not defined in the 
environment, printenv returns exit status 1, else it returns 
status 0. 


SEE ALSO 

sh(l), environ(5), csh{l) 


BUGS 


Page 1 


(printed 8/22/83) 



PROF(l) 


NAME 


Nu Machine UNIX Programmer's Manual 


prof ~ display profile data 
SYNOPSIS 

prof L -V ] C -a ] [ -1 ] C -low C -high 


DESCRIPTION 

Prof interprets the file mon . out produc 
subroutine. Under default modes, the s 
named object file (a. out default) is re 
with the mon . out profile file. For eac 
the percentage of time spent executing 
and the next is printed (in decreasing 
the number of times that routine was ca 
of milliseconds per call. 


PROP(l) 


] ] C file ] 


id by the monitor 
’mbol table in th^ 
id and correlated 
external symbol 
>etween that symb<j) 
)rder), together 
■ led and the numb4 


1 

virith 

r 


If the -a option is used, all symbols 
than just external symbols. If the -1 
outi^ut is listed by symbol value rather 
percentage. 


are 


reported rather 
<}>ption is used, tlje 
than decreasing 


If the -V option is used, all printing 
graphic version of the profile is produi 
output for display by the plot (1) filteij' 
and high , by default 0 and 100, cause a 
of the profile to be plotted with accor 
resolution. 


is 


suppressed and 
ed on the standart 
s. The numbers 
selected percentej 
dingly higher 


In order for the number of calls to a r 
the -p option of cc must have been giveii 
containing the routine was compiled. tH 
arranges for the mon . out file to be pro 


putine to be tallijed, 
when the file 
is option also 
duced automaticallj 


a 

d 

low 


ge 


FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

monitor(3), profil(2), cc(l), plot(l) 

BUGS 

Beware of quantization errors. 


m) 
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NAME 

prs - print an SCCS file 
SYNOPSIS 

prs C-dCdataspec]] C-rCsiD]] C-e] C-l] C-a] files 
DESCRIPTION 

Prs prints, on the standard output, parts or all of an SCCS 
file (see sccsfile (5)) in a user supplied format. If a 
directory is named, prs behaves as though each file in the 
directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin 
with s.), and unreadable files are silently ignored. If a 
name of - is given, the standard input is read; each line of 
the standard input is taken to be the name of an SCCS file 
or directory to be processed; non-SCCS files and unreadable 
files are silently ignored. 

Arguments to prs , which may appear in any order, consist of 
keyletter arguments, and file names. 

All the described keyletter arguments apply independently to 
each named file; 


-dC dataspec ] Used to specify the output data 

specification. The dataspec is a string 
consisting of SCCS file data keywords 
(see DATA KEYWORDS ) interspersed with 
optional user supplied text. 


-rC siD ] 



-1 


Used to specify the £CCS IDentification 
(SID) string of a delta for which 
information is desired. If no SID is 
specified, the SID of the most recently 
created delta is assumed. 

Requests information for all deltas 
created earlier than and including the 
delta designated via the -r keyletter. 

Requests information for all deltas 
created later than and including the 
delta designated via the -r keyletter. 


~3l Requests printing of information for 

both removed, i.e., delta type = R, (see 
rmdel (1)) and existing, i.e., delta type 
= D, deltas. If the -a keyletter is not 
specified, information for existing 
deltas only is provided. 

DATA KEYWORDS 
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Data keywords specify which parts of an 
retrieved and output. All parts of an S<bi 
sccsfile (5)) have an associated data keywi 
limit on the number of times a data keywo 


dataspe c. 


?CCS file are to pe 
CS file (see 
ord. There is neb 
rd may appear in a 


<bf 1 


The information printed by prs consists 
supplied text; and (2) appropriate value^ 
the sees file) substituted for the rec' 
keywords in the order of appearance in t^ 
format of a data keyword value is either 

which keyword substitution is direct, or Multi-line IM}, in 
which keyword substitution is followed by a carriage return 


(1) the user 
(extracted from 
ognized data 
e dataspec . The 
Simple (S), in 
Multi-line (M), 


User supplied text is any text other thaiji 
keywords. A tab is specified by \t and 
return/new-line is specified by \n. 


recognized data 
Carriage 


PRStl) 
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EXAMPLES 

prs -■d''Users and/or user IDs for :F: arexXnsUNs” s.file 

may produce on the standard output: 

Users and/or user IDs for s.file are; 

xyz 

131 

abc 

prs -d''Newest delta for pgra :M:; :I: Created tD; By 
;p." -r s.file 

may produce on the standard output: 

Newest delta for pgm main.c; 3.7 Created 77/12/1 By cas 
As a special case ; 
prs s.file 

may produce on the standard output; 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 
MRS: 

bl78-12345 

bl79-54321 

COMMENTS: 

this is the comment line for s.file initial delta 

for each delta table entry of the "d'' type. The only 
keyletter argument allowed to be used with the special case 
is the -a keyletter. 


FILES 

/trap/pr????? 


SEE ALSO 

admin(l), delta(l), get(l), help(l), sccsfile(5). 

Source Code Control System User 's Guide by L. E. Bonanni and 
C. A. Salemi. 


DIAGNOSTICS 

Use help d) for explanations. 
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NAME 


ps - process status 


SYNOPSIS 

ps C acgklrstuvwx# C corefile 3 C swapf:^le ] [ system ] 1 


DESCRIPTION 

Ps prints certain indicia about active 
complete printout on the console or IprJ 
For a quick snapshot of system activity; 
recommended. A minus may precede optiorjii 
The following options may be specified 


asks for information about all proo 
(ordinarily only one's own processe 

causes only the comm field to be di 
the arguments. (The comm field is 
name of the file the process last el 
speeds up somewhat and reduces t 
It is also more reliable since the 
scribble on top of it. 


esses with terminals 
s are displayed). 

splayed instead of 
the tail of the path 
xec'ed.) This oi^tion 
he amount of output, 
process can't 


Asks for^all processes. Without tli 
prints ''interesting'' processes, 
to be uninteresting if they are pr4 
or if their arguments begin with a 
eliminates shells and getty process! 

causes the file / usr / sys / core is us^ 
/ dev / kmem and / dev / mem . This is ug 
system debugging. 


r 


asks for a long listing. The short 
the user name/ process ID, tty, the 
execution time of the process and a 
the command line. 

asks for "raw output". A non-human 
of structures is output on the stan 
is one structure for each process, 
defined by <psout.h> 

Print the size of the kernel stack 
This may only be used with the shor 
for use by system developers. 


t ttyname 

restricts output to processes whose 
the specified ttyname (which should 
printed by ps , e.g. tty3 for tty3, 
console, tttydP for ttyd0, t? for p 


P3(l) 


rocesses. To get 
use "ps axlgw'^ 

% ^ II* 

ps au xs 
s with no effect. 


is option, ps only 
Processes are deemed 
cess group leaders. 
This normally 

es. 

ed in place of 
ed for postmortem! 


listing contains 
cumulative 
In approximation tb 


readable sequence 
dard output. There 
the format is 


of each process. 
t listing, and is 


controlling tty is 
be specified as 
tconsole for 
bocesses with no 
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tty, etc). This option must be the last one given. 

u A user oriented output is produced. This includes the 
neune of the owner of the process, process id, nice 
value, size, resident set size, tty, cpu time used, and 
the command. 

w tells ps you are on a wide terminal (132 columns). Ps 
normally assumes you are on an 80 column terminal. 

This information is used to decide how much of long 
commands to print. The w option may be repeated, e.g. 
ww, and the entire command, up to 128 characters, will 
be printed without regard to terminal width. 

X asks even about processes with no terminal. 

# A process number may be given, (indicated here by #), 

in which case the output is restricted to that process. 
This option must also be last. 

A second argument tells ps where to look for core if the k 
option is given, instead of /vmcore. A third argument is“ 
the name of a swap file to use instead of the default 
/dev/drum. If a fourth argument is given, it is taken to be 
the file containing the system's namelist. Otherwise, 
"/vraunix'V is used. 

The output is sorted by tty, then by process ID. 

The long listing is columnar and contains 

F Flags associated with the process. These are defined 
by #define lines in /usr/include/sys/proc.h. 

S The state of the process. 0: nonexistent; S: sleeping; 
W; waiting; R: running; I: intermediate; Z: terminated; 
T: stopped. 

UID The user id of the process owner. 

PID The process ID of the process; as in certain cults it 
is possible to kill a process if you know its true 
name. 

PPID The process ID of the parent process. 

CPU Processor utilization for scheduling. 

PRI The priority of the process; high numbers mean low 
priority. 

NICE Used in priority computation. 
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ADDR The memory address of the process 
otherwise the disk address. 


SZ The size in blocks of the memory in|age of the proces| 
WCUAl^ 


The event for which the process is 
if blank, the process is running. 


P9(l) 


f resident. 


s. 


waiting or sleepi 


hg; 


TTY The controlling tty for the process. 

TIME The cumulative execution time for the process. 


COMMAl^D 

The command and its arguments. 

A process that has exited and has a pare 
been waited for by the parent is marked 
an educated guess as to the file name an 
when the process was created by examinin 
area. The method is inherently somewhat 
any event a process is entitled to destr 
so the names cannot be counted on too mu 


nt, but has not ybt 
<defunct>. Ps makes 
d arguments given 
g memory or the sWap 
unreliable and in 
joy this in format ipn, 
ch. 


FILES 

/vmunix 
/dev/kmem 
/dev/drum 
/vracore 
/dev 

SEE ALSO 

kill(l), w(l) 


system namelist 
kernel memory 
swap device 
core file 
searched to find swap devi 


ce and tty names 


BUGS 


Things can change while ££ is running; the picture it givps 
is only a close approximation to reality 


Processes with large environiaents, which 
the command in a block other than the to 
are not correctly printed by ps, which o 
block in memory. Thus, users using the 
variable will probably only have their c 
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NAME 

pstat - print system facts 
SYNOPSIS 

pstat C -aixptuf 3 C suboptions ] C file ] 

DESCRIPTION 

Pstat interprets the contents of certain system tables. If 
file is given, the tables are sought there, otherwise in 
/ dev/mem . The required namelist is taken from /unix. Options 
are ~ 


-a Under -p, describe all process slots rather than just 
active ones. 

-i Print the inode table with the these headings; 

LOG The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus; 

L locked 

U update time filsvs (5)) must be corrected 

A access time must be corrected 

M file system is mounted here 

W wanted by another process (L flag is on) 

T contains a text file 

C changed time must be corrected 

CNT Number of open file table entries for this inode. 

DEV Major and minor device number of file system in which 
this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod (2). 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV 

Number of bytes in an ordinary file, or major and 
minor device of special file. 

”X Print the text table with these headings; 

LOG The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus; 

T ptrace (2) in effect 
W text not yet written on swap device 
L loading in progress 

K locked 

w wanted (L flag is on) 

DADDR Disk address in swap, measured in multiples of 512 
bytes. 

GADDR Gore address, measured in multiples of 64 bytes. 
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SIZE Size of text segment, measured in multiples of 64 
bytes. 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Nvunber of processes in core using this text segment. 

-p Print process table for active processes with these 
headings: 

LOG The core location of this table entry. 

S Run state encoded thus: 

0 no process 
1 waiting for some event 

3 runnable 

4 being created 

5 being terminated 

6 stopped under trace 

F Miscellaneous state variables, or-ed together: 

01 loaded 

02 the scheduler process 

04 locked 

010 swapped out 

020 traced 

040 used in tracing 

0100 locked in by lock (2). 

PRI Scheduling priority, see nice (2). 

SIGNAL 

Signals received (signals 1-16 coded in bits 0-15), 

UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 127. 
CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see nice (2). 

PGRP Process number of root of process group (the opener of 
the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR If in core, the physical address of the 'u-area* of 
the process measured in multiples of 64 bytes. If 
swapped out, the position in the swap area measured in 
multiples of 512 bytes. 

SIZE Size of process image in multiples of 64 bytes. 

WCHAN Wait channel number of a waiting process. 

LINK Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table 
entry. 

CLKT Countdown for alarm (2) measured in seconds. 

-t Print table for terminals (only DHIL and DLll handled) 
with these headings: 
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RAW Number of characters in raw input queue. 

CAN Number of characters in canonicalized input queue. 

OUT Number of characters in putput queue. 

MODE See tty (4). 

ADDR Physical device address. 

DEL Number of delimiters (newlines) in canonicalized input 
queue. 

COL Calculated column position of terminal. 

STATE Miscellaneous state variables encoded thus: 

W waiting for open to complete 
O open 

S has special (output) start routine 

C carrier is on 

B busy doing output 

A process is awaiting output 

X open for exclusive use 

H hangup on close 

PGRP Process group for which this is controlling terminal. 

-u print information about a user process; the next 

argument is its address as given by ^£(1). The 
process must be in main memory, or the file used can 
be a core image and the address 0. 

-f Print the open file table with these headings: 

LOC The core location of this table entry. 

PLG Miscellaneous state variables encoded thus: 

R open for reading 

W open for writing 

P pipe 

CNT Number of processes that know this open file. 

INO The location of the inode table entry for this file. 
OFFS The file offset, see lseek (2). 

FILES 

/unix namelist 

/dev/raem default source of tables 

SEE ALSO 

ps(l), stat(2), filsys(5) 

K. Thompson, UNIX Implementation 
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NAME 


ptx - permuted index 


SYNOPSIS 

ptx C option ] 


C input C output 3 3 


DESCRIPTION 

Ptx generates a permuted index to file input on file output 
(standard input and output default). It 
the first does the permutation, generatiji 
keyword in an input line. The keyword 
front. The permuted file is then sorted 
sorted lines are rotated so the keyword 
of the page. Ptx produces output in the 


i& 


.XX "tail" "before keyword" "keyword and after" "head" 


where .XX may be an nroff or troff (1) ma 
formatting. The before keyword and keyword and after fie 


fit around the 
of the page. 

and head , at least one of which is an em^ty string "' 
wrapped—around pieces small enough to fit in the unused 


incorporate as much of the Ixne as will 
keyword when it is printed at the middle 


PTX(l) 


has three phases 
g one line for e 
rotated to the 
Finally, the 
|::omes at the midd 
form: 


lach 


e 


jsro for user-defined 

Ids 


Tail 


are 


space at the opposite end of the line, 
must be discarded, '/' marks the spot. 

The following options can be applied: 

-f Fold upper and lower case letters f 

-t Prepare the output for the phototyp 
line length is 100 characters. 

-w n Use the next argument, n, as the wi 
line. The default line length is 7 


When original text 


pr sorting. 

^setter; the default 


dth of the output 
2 characters. 


umi 


-g n Use the next argument, n, as the n 
to allow for each gap among the fou 
as finally printed. The default ga 

-o only 

Use as keywords only the words give 


-i ignore 

Do not use as keywords any words gi 
file. If the -i_ and -o options ar^ 
/usr/lib/eign as the ignore file. 


-b break 

Use the characters in the break fil 
In any case, tab, newline, and spacj 
always used as break characters. 
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iber of character 
r parts of the li 
IP is 3 characters 

n in the only fil 

ven in the ignore 
missing, use 


e to separate wor|ds • 
e characters are 
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-r Take any leading nonblank characters of each Input line 
to be a reference Identifier (as to a page or chapter) 
separate from the text of the line. Attach that 
Identifier as a 5th field on each output line. 

The index for this manual was generated using ptx . 


FILES 

/bin/sort 
/usr/lib/eign 


BUGS 

Line length counts do not account for overstriking or 
proportional spacing. 
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NAME 


pwd - working directory name 

SYNOPSIS 

pwd 


DESCRIPTION 

Pwd prints the pathname of the working 


SEE ALSO 

cd(l) 
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NAME 

ranlib - convert archives to random libraries 
SYNOPSIS 

ranlib archive ... 

DESCRIPTION 

Ranlib converts each archive to a form which can be loaded 
more rapidly by the loader, by adding a table of contents 

named _.SYMDEF to the beginning of the archive. It uses 

^(1) to reconstruct the archive, so that sufficient 
temporary file space must be available in the file system 
containing the current directory. 

SEE ALSO 

ld(l), ar(l) 


BUGS 

Because generation of a library by ^ and randomization by 
ranlib are separate, phase errors are possible. The loader 
Id warns when the modification date of a library is more 
recent than the creation of its dictionary; but tliis means 
you get the warning even if you only copy the library. 
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NAME 


ratfor - rational Fortran dialect 


SYNOPSIS 

ratfor C option ... ] C filename ... ] 

DESCRIPTION 

Ratfor converts a rational dialect of Foi: 


irrational Fortran. Ratfor provides con 
essentially identical to those in C: 

statement grouping; 

{ statement; statement; statement } 


decision-making: 

if (condition) statement C else statement 3 
switch (integer value) { 

case integer: statement 


tran into ordinary 
trol flow constructs 


} 


[ default: ] statement 


loops: 

while (condition) statement 
for (expression; condition; express 
do limits statement 
repeat statement C until (condition 
break Cn] 
next [n] 


and some syntactic sugar to make programs easier to read and write 


continuation 


free form input: 

multiple statements/line; automatic 
comments: 

# this is a comment 

translation of relationals: 

>, >=, etc., become .GT., .GE., etc 


return (expression) 

returns expression to caller from filinction 
define: 

define name replacement 
include: 

include filename 


be 


The option -h causes quoted strings to 
constructs. -C copies comments to the o 


RATFOR(1) 


ion) statement 

3 


turned•into 27H 
lit put, and attempts 
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to format it neatly. Normally, continuation lines are 
marked with a & in column 1; the option -6x makes the 
continuation character x and places it in column 6. 

Ratfor is best used with f77 (1). 

SEE ALSO 

f77(l) 

B. W. Kernighan and P. J. Plauger, Software Tools , Addison- 
V7esley, 1976. 
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NAME 


restor - incremental file system restore 


SYNOPSIS 

restor key C argument ... ] 

DESCRIPTION 

Restor is used to read magtapes dumped w 
command. The key specifies what is to 
of the characters rRxt optionally combine 


Use the first argument as the name 
of the default. 


r or R 

The tape is read and loaded into th^ 
specified in argument . This should 
(see below). If the key is R resto^ 
a multi volume set to start onT Thi 


be interrupted and then restarted ( 
done before 


RESTOR(iM) 


:jLth the dump 

done. Key is or^e 
d with f. 


of the tape instead 


file system 
r^ot be done light]| 
asks which tape 
s allows restor 
icheck -s must 


an 


It then asks you to 'mount the desired tape volume*. 
Type the number of the volume you choose. On a 
raultivolume dump the recommended procedure is to mounj 
the last through the first volume in that order. 


on 


Each file on the tape named by an argument is 
extracted. The file name has all 'njiount' prefixes 
removed; for example, /usr/bin/lpr is named /bin/lpr 
the tape. The file extracted is placed in a file with 
a numeric name supplied by restor (actually the inode 
number). In order to keep the amount of tape read tc 
minimum, the following procedure is |recommended: 

Mount volume 1 of the.set of dump tapes 

Type the resto r command. 

Restor will announce whether or not 
give the number it will name the filj 
tape. 


y 

of 


to 


be 


it found the file 
e, and rewind the 


Restor checks to see if any of the 
on the mounted tape (or a later tapej 
order) and doesn't read through the 
are. If you are working with a sing 
the number of files being restored 

the query with 'l' and restor will x|ead the tapes in 
sequential order. 


If you have a hierarchy to restore 
dumpdir(l) to produce the list of nal: 


iles requested ar 
, thus the revers 
tape if no files 
le volume dump or| 
s large, respond 


ou can use 
mes and a shell 


to 
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script to move the resulting files to their homes. 

t Print the date the tape was written and the date the 
filesystem was dumped from. 

The r option should only be used to restore a complete dump 
tape onto a clear file system or to restore an incremental 
dump tape onto this. 

A dump followed by a mkfs and a restor is used to change the 
size of a file system. 


FILES 

default tape unit varies with installation 
rst* 


SEE ALSO 

dump(l), nikfs(l), dumpdir(l) 

DIAGNOSTICS 

There are various diagnostics involved with reading the tape 
and writing the disk. There are also diagnostics if the i- 
list or the free list of the file system is not large enough 
to hold the dump. 

If the dump extends over more than one tape, it may ask you 
to change tapes. Reply with a new-line when the next tape 
has been mounted. 


BUGS 

There is redundant information on the tape that could be 
used in case of tape reading problems. Unfortunately, 
restor doesn't use it. 
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NAME 


rra, rmdir - remove (unlink) files 


SYNOPSIS 

rm C -fri 3 file ... 
rmdir dir ... 

DESCRIPTION 

Rm removes the entries for one or more 


RM(1) 


lies from a 


directory. If an entry was the last lirik to the file, the 


file is destroyed. Removal of a file r 
permission in its directory, but neither 
permission on the file itself. 


If a file has no write permission and th 
a terminal, its permissions are printed 
from the standard input. If that line 
file is deleted, otherwise the file rem4 
are asked when the -f (force) option is 


e standard input is 
and a line is read 
tjegins with 'y' the 
ins. No questions 
given. 


If a designated file is a directory, an 
printed unless the optional argument -r 
that case, rm recursively deletes the en 
specified directory, and the directory i 


If the -i (interactive) option is in eff 
to delete each file, and, under -r, vdietj 
directory. 


Rmdir removes entries for the named dire] 
be empty. 


SEE ALSO 

unlink(2) 

DIAGNOSTICS 

Generally self-explanatory. 


quires write 
read nor write 


error comment is 
has been used, in 
tire contents of |the 
tself. 


ect, rm asks whether 
iier to examine each 


ctories, which mu 


pt 


file '..' merely to avoid the antisocial 
inadvertently doing something like 'rm -t 


It is forbidden to remove the 


consequences of 

* • 


Page 1 


(printed 8/22/83) 




RMDEL(l) 


RMDEL(l) 


Nu Machine UNIX Programmer's Manual 


NAME 

rmdel - remove a delta from an SCCS file 
SYNOPSIS 

rmdel -rSID files 
DESCRIPTION 

Rmdel removes the delta specified by the SID from each named 
SCCS file. The delta to be removed must be the newest (most 
recent) delta in its branch in the delta chain of each named 
SCCS file. In addition, the specified must not be that of 
a version being edited for the purpose of making a delta (i. 
e., if a p- file (see get (l)) exists for the named SCCS file, 
the specified must not appear in any entry of the p- file ). 

If a directory is named, rmdel behaves as though each file 
in the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does not 
begin with s.) and unreadable files are silently ignored. 

If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an 
SCCS file to be processed; non-SCCS files and unreadable 
files are silently ignored. 

The exact permissions necessary to remove a delta are 
documented in the Source Code Control System User 's Guide . 
Simply stated, they are either (l) if you make a delta you 
can remove it; or (2) if you own the file and directory you 
can remove a delta. 


FILES 

x-file (see delt a(l)) 

z-file (see delta(l)) 


SEE ALSO 

delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System User's G uide by L. E. Bonanni and 
C. A. Salemi. 


DIAGNOSTICS 

Use help (l) 


for explanations. 
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NAME 


rmdir, rm - remove (unlink) directories or files 


SYNOPSIS 

rmdir dir ... 

rm C-f]C-r!lC-i3C-3 file ... 

DESCRIPTION 

Rmdir removes entries for the named directories, which mtist 
be empty. 

Rm removes the entries for one or more files from a 
dTrectory. If an entry was the last link to the file, tlie 
file is destroyed. Removal of a file requires write 
permission in its directory, but neithej: read nor write 
permission on the file itself. 

If a file has no write permission and tlie standard input is 
a terminal, its permissions are printed and a line is read 
from the standard input. If that line begins with 'y‘ tie 
file is deleted, otherwise the file remains. No questiors 
are asked and no errors are reported wh4n the -f (force) 
option is given. 

If a designated file is a directory, an error comment is 
printed unless the optional argument -r has been used. In 
that case, rm recursively deletes the er.tire contents of the 
specified directory, and the directory itself. 

If the -i (interactive) option is in effect, rm asks whether 
to delete each file, and, under -r, whether to examine each 
directory. 

The null option - indicates that all the arguments following 
it are to be treated as file names. This allows the 
specification of file names starting with a minus. 

SEE ALSO 

rra(l), unlink(2), mdlr(2) 

MESSAGES 

rmdir: arg count 

You must specify at least one directory name for 
rmdir. 


rmdir; cannot remove . or .. 

You cannot remove the current directory or the 
parent directory of the current directory. 


rmdir: directory non-existent 

The directory specified by directory could not be 
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rmdir; 

rmdir; 

rmdir: 

rmdir: 

rmdir: 

rmdir: 

rmdir: 


found - Chech the spelling, 
cannot .stat 

The indicated directory cannot be found/ or you 
don't have search permission for it. 

directory not a directory 

The object specified by directory is not a 
directory - rmdir will not remove ordinary files. 

cannot remove current directory 

You cannot remove the current directory. 

directory unreadable 

The directory specified by directory cannot be 
read - the permissions are probably not correct. 

directory not empty 

A directory cannot be removed while it still has 
files in it. 

directory : no permission 

The parent directory containing the directory 
specified by directory does not have write 
permission. 

directory not removed 

This message indicates you are trying to remove a 
directory you don't own. 
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NAME 


sact - print current SCCS file editing activity 


SYNOPSIS 

sact files 

DESCRIPTION 

Sact informs the user of any impending 4 
SCCS file. This situation occurs when 
option has been previously executed with 
execution of delta (l). If a directory i 
command line, sact behaves as though eac 
directory were specified as a named file 
SCCS files and unreadable files are sile 
name of - is given, the standard input i 
line being taken as the name of an SCCS 
processed. 


SACT 


eltas to a named 
et(l) with the -e 
out a subsequent 
s named on the 
h file in the 
except that non 
htly ignored. If 
s read with each 
file to be 


The output for each named file consists pf five fields 
separated by spaces. 


Field 1 

Field 2 

Field 3 

Field 4 
Field 5 


specifies the SID of a 
exists in the SCCS file 


delta that curren 
to which changes 


will be made to make the new delta. 


specifies the SID for tpe new delta to bp 
created. 

contains the lognarae ofI the user who will 
make the delta (i.e. executed a get for 
editing). 


contains the date that 
contains the time that 


( 1 ) 


4 / 


SEE ALSO 

delta (1), get (1), <anget (1). 
DIAGNOSTICS 

Use help d) for explanations. 


[et -e was executed, 
fet -e was executesd. 
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NAME 

sccsdiff - compare two versions of an SCCS file 
SYNOPSIS 

sccsdiff -rSIDl -rSID2 C-p] C-sn] files 


DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates 
the differences between the two versions. Any number of 
SCCS files may be specified, but arguments apply to all 
files. 


-rSID? 


“P 


SIDl and SID2 specify the deltas of an SCCS 
file that are to be compared. Versions are 
passed to bdiff (1) in the order given. 

pipe output for each file through pr(1). 


“Sn n is the file segment size that bdiff will 

pass to diff (1). This is useful when diff 
fails due to a high system load. 


PILES 

/tmp/get????? Temporary files 


SEE ALSO 

bdiff(l), get{l), help(l), pr(l). 

Source Code Control System User 's Guideb y L. E. Bonanni and 
C. A. Salemi. 


DIAGNOSTICS 

* ^ file : No differences'' If the two versions are the same. 
Use help (l) for explanations. 
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NAME 

sed ~ stream editor 
SYNOPSIS 

sed C -n ] C -e script ] C -f sfile ] C file ] ... 
DESCRIPTION 

Sed copies the named files (standard injiut default) to the 
standard output, edited according to a script of commands. 
The -f option causes the script to be taken from file sfile ; 
these options accumulate. If there is "ust one -e option 
and no -f s, the flag -e may be omitted. The -n option 
suppresses the default output. 

A script consists of editing commands, one per line, of the 
following form; 

Caddress [, address] ] function [arguments] 

In normal operation sed cyclically copies a line of input 
into a pattern space (unless there is scmething left after a 
'D* command), applies in sequence all ccmmands whose 
addresses select that pattern space, and at the end of the 
script copies the pattern space to the standard output 
(except under -n) and deletes the pattern space. 

An address is either a decimal number that counts input 
lines cumulatively across files, a that addresses the 
last line of input, or a context address, '/regular 
expression/', in the style of ed(l) modified thus: 

The escape sequence '\n' matches a newline embedded in 
the pattern space. 

A command line with no addresses selects every pattern 
space. 

A command line with one address selects each pattern space 
that matches the address. 

A command line with two addresses selects the inclusive 
range from the first pattern space that matches the first 
address through the next pattern space that matches the 
second. (If the second address is a number less than or 
equal to the line number first selected, only one line is 
selected.) Thereafter the process is repeated, looking again 
for the first address. 

Editing commands can be applied only to non-selected pattarn 
spaces by use of the negation function '1* (below). 

In the following list of functions the maximum number of 
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permissible addresses for each function is indicated in 
parentheses. 

An argument denoted text consists of one or more lines, all 
but the last of which end with '\' to hide the newline. 
Backslashes in text are treated like backslashes in the 
replacement string of an 's' command, and may be used to 
protect initial blanks and tabs against the stripping that 
is done on every script line. 

An argument denoted rfile or wfile must terminate the 
command line and must be preceded by exactly one blank. 

Each wfile is created before processing begins. There can 
be at most 10 distinct wfile arguments. 

(1) a\ 
text 

Append. Place text on the output before reading the 
next input line. 

(2) b label 

Branch to the ':' command bearing the label . If label 
is empty, branch to the end of the script. 

(2)e\ 

text 

Change. Delete the pattern space. With 0 or 1 address 
or at the end of a 2-address range, place text on the 
output. Start the next cycle. 

(2)d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through 
the first newline. Start the next cycle. 

(2)g Replace the contents of the pattern space by the 
contents of the hold space. 

(2)G Append the contents of the hold space to the pattern 
space. 

(2)h Replace the contents of the hold space by the contents 
of the pattern space. 

(2)11 Append the contents of the pattern space to the hold 
space. 

(1) i\ 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an 

unambiguous form. Non-printing characters are spelled 
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in two digit ascii, and long lines 


{2)n Copy the pattern space to the standard output. Rep 
the pattern space with the next line of input. 


(2)N Append the next line of input to the pattern space with 


an embedded newline. (The current 
changes.) 


(2)p Print. Copy the pattern space to 1:he standard output. 

(2)P Copy the initial segment of the patitern space throuch 
the first newline to the standard output. 

(l)q Quit. Branch to the end of the sci-ipt. Do not star|t a 
new cycle. 


SEp(l) 


are folded. 


line number 


ace 


(2)r rfile 


Read the contents of rfile . Place 
before reading the next input lineJ 


(2)s/ regular expression / replacemerit/flags 


Substitute the replacement string for instances of the 
regular expression in the pattern space. Any charac 


may be used instead of '/'. For a 


see ed(l). Flags is zero or more of 

g Global. Substitute for all nonoverlapping 

instances of the regular expression rather than] 
just the first one. 

p Print the pattern space if a rjeplaceraent was ma|de. 
w wfile 

Write. Append the pattern spe^ce to wfile if a 
replacement was made. 

(2)t label 

Test. Branch to the command bearing the label if 
any substitutions have been made since the most recent 
readiiig of an input line or executi 
label is empty, branch to the end o 


them on the outpu 


fuller descriptiq 


ter 

in 


nee the most rece: 
on of a 't*. If 
f the script. 


(2)w wfile 

Write. Append the pattern space to 

(2)x Exchange the contents of the patter 

(2)y/ stringl / string2 / 

Transform. Replace all occurrences 
stringl with the corresponding char 
The lengths of stringl and string2 


wfile. 


n and hold spaces 


of characters in 
|acter in string2 . 
must be equal. 


Page 3 


(printed 8/22/83) 



SED(l) 


SED(l) 


Nu Machine UNIX Programmer's Manual 


(2)i function 

Don't. Apply the function (or group, if function is 
'{') only to lines not selected by the address(es). 

(0): label 

This command does nothing; it bears a label for 'b* and 
't* commands to branch to. 

(1) = Place the current line number on the standard output as 

a line. 

(2) { Execute the following commands through a matching 

only when the pattern space is selected. 

(0) An empty command is ignored. 

SEE ALSO 

ed(l), grep(l), awk(l) 
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NAME 

sfnt - select loaded font 
SYNOPSIS 

sfnt C fontnum ] 


DESCRIPTION 

Sfnt selects the current font in use to foe fontnum . The ffont 
must have already been loaded into the window using Ifnt. 
Fontnum must be in the range 0 to 7. If fontnum is not 
specified, it defaults to 7 which is the] 
the window. 


default font for 


SEE ALSO 

Ifnt(l) Isfnt(l) cfnt(l) 


3) 
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NAME 

sfsck - file system consistency check and interactive repair 

SEE 

fsck(l) 


Page 1 


(printed 8/22/83) 



SH(1) 


Nu Machine UNIX Programmer's Manual 


NAME 


sh# for, case, if, while, :, ., break, 
exec, exit, export, login, newgrp, read^ 
shift, times, trap, umask, wait - comma: 


(fontinue, cd, evai, 
readonly, set, 

4d language 


SYNOPSIS 

sh C -ceiknrstuvx ] [ arg ] ... 


DESCRIPTION 

Sh is a command programming language th4 
read from a terminal or a file. See in 
meaning of arguments to the shell. 


Commands. 

A simple-command is a sequence of non blank words separatjed 
by blanks (a blank is a tab or a space). The first word 
specifies the name of the command to be executed. Except as 
specified below the remaining words are passed as arguments 
to the invoked command. The command name is passed as 
argument 0 (see exec(2)). The value of 


sk(i) 


t executes comman|ds 
Vocation for the 


its exit status if it terminates normal! 
it terminates abnormally (see signal (2) 
values). 

^ pipeline is a sequence of one or more 
by I. Thestandard output of each comman 
connected by a pipe (2) to the standard i 
command. Each command is run as a separ 
shell waits for the last command to term 


a simple-command is 
jy or 200 +status if 
for a list of status 


commands separateji 
,d but the last is 
pput of the next 
ate process; the 
inate. 


A list is a sequence of one or more pipe l 
7 , &, && or II and optionally terminated 


have equal precedence which is lower tha 
&& and I I also have equal precedence. Ai 
sequential execution; an ampersand cause 
pipeline to be executed without waiting 
The symbol && (II) causes the list folio] 
only if the preceding pipeline returns a 
value. Newlines may appear in a list , i 
semicolons, to delimit commands. 

A command is either a simple-command or 
following. The value returned by a coram. 
last simple-command executed in the command. 


ines separated by 

or &. ; and & 


by 7 or 5t. 7 an 

)i that of && and 
semicolon causes 
s the preceding 
for it to finish, 
wing to be executed 
zero (non zero) 
hstead of 


one of the 
and is that of th4 


for name [in word ... 3 do list done 

Each time a for command is executed 


next word in the for word list If in word 
omitted then in is assumed, 

there are no more words in the list 


Execution ends when 


case word in [ pattern [ I pattern 3 
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is 


the 
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A case command executes the list associated with the 
first pattern that matches word * The form of the 
patterns is the same as that used for file name 
generation. 

if list then list Celif list then list ] . .. [else list ] fi 
The list following if is executed and if it returns 
zero the list following then is executed. Otherwise, 
the list following elif is executed and if its value is 
zero the list following then is executed. Failing that 
the else list is executed. 

while list [do list ] done 

A while command repeatedly executes the while list and 
if its value is zero executes the do list ; otherwise 
the loop terminates. The value returned by a while 
command is that of the last executed command in the do 
list , until may be used in place of while to negate the 
loop termination test. 

( list ) 

Execute list in a subshell. 

{ list } 

list is simply executed. 

The following words are only recognized as the first word of 
a command and when not quoted. 

if then else elif fi case in esac for while until do 
done { } 

Conunand substitution. 

The standard output from a command enclosed in a pair of 
grave accents ('') may be used as part or all of a word; 
trailing newlines are removed. 

Par€uneter substitution. 

The character $ is used to introduce substitutable 
pareuneters. Positional pareuneters may be assigned values by 
set. Variables may be set by writing 

name=value [ name= » value ] ... 

${ parameter } 

^ parameter is a sequence of letters, digits or 
underscores (a name), a digit, or any of the characters 
* @ # ? - $ 1. The value, if any, of the iJarameter is 
substituted. The braces are required only when 
parameter is followed by a letter, digit, or underscore 
that is not to be interpreted as part of its name. If 
parameter is a digit then it is a positional parameter. 
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If parameter is * or @ then all the positional 
parameters, starting with $1, are substituted separated 
by spaces. §0 is set from argument, zero when the shell 
is invoked. 

${ parameter~word ) 

If parameter is set then substitute its value; 
otherwise substitute word . 

${ parameter=word } 

If parameter is not set then set it to word; the value 
of the parameter is then substituted. Positional 
parameters may not be assigned to in this way. 

${ parameter ? word } 

If parameter is set then substitute its value; 
otherwise, print word and exit from the shell. If w ord 
is omitted then a standard message is printed. 

$( parameter+word } 

If parameter is set then substitute word ; otherwise 
substitute nothing. 

In the above word is not evaluated unless it is to be usei 
as the substituted string. (So that, for example, echo 
${d-'pwd'} will only execute pwd if d is unset.) 

The following parameters are automatically set by the shell. 

# The number of positional parameters in decimal. 

- Options supplied to the shell on invocation or by 

set. 

? The value returned by the last executed command in 
decimal. 

$ The process number of this shell. 

I The process number of the last background command 

invoked. 

The following parameters are used but not set by the shell. 

HOME The default argument (home directory) for the cd 
command. 

PATH The search path for commands (see execution). 

MAIL If this variable is set to the name of a mail f:.le 
then the shell informs the user of the arrival of 
mail in the specified file. 

PSl Primary prompt string, by default '$ '. 

PS2 Secondary prompt string, by default '> '. 

IFS Internal field separators, normally space, tab, 
and newline. 

Blank interpretation. 
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After parameter and command substitution, any results of 
substitution are scanned for internal field separator 
characters (those found in $IFS) and split into distinct 
arguments where such characters are found. Explicit null 
arguments (or '') are retained. Implicit null arguments 
(those resulting from parameters that have no values) are 
removed. 

File ncime generation. 

Following substitution, each command word is scanned for the 
characters *, ? and [. If one of these characters appears 
then the word is regarded as a pattern. The word is 
replaced with alphabetically sorted file names that match 
the pattern. If no file name is found that matches the 
pattern then the word is left unchanged. The character . at 
the start of a file name or immediately following a /, and 
the character /, must be matched explicitly. 

* Matches any string, including the null string. 

? Matches any single character. 

c...] 

Matches any one of the characters enclosed. A pair of 
characters separated by - matches any character 
lexically between the pair. 

Quoting. 

The following characters have a special meaning to the shell 
and cause termination of a word unless quoted. 

; & ( ) I < > newline space tab 

A character may be quoted by preceding it with a \. 

\newline is ignored. All characters enclosed between a pair 
of quote marks (''), except a single quote, are quoted. 
Inside double quotes ('*") parameter and command substitution 
occurs and \ quotes the characters \ ' " and $. 

”$*" is equivalent to "$1 $2 ..." whereas 
is equivalent to "$1" "$2" .... 

Prompting. 

When used interactively, the shell prompts with the value of 
PSl before reading a command. If at any time a newline is 
typed and further input is needed to complete a command then 
the secondary prompt ($PS2) is issued. 

Input output. 

Before a command is executed its input and output may be 
redirected using a special notation interpreted by the 
shell. The following may appear anywhere in a simple- 
command or may precede or follow a command and are not 
passed on to the invoked command.. Substitution occurs 
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before word or digit is used. 

< word 

Use file word as standard input (fi.le descriptor 0). 

> word 

Use file word as standard output (file descriptor 1). 

If the file does not exist then it is created? 
otherwise it is truncated to zero length. 

> > word 

Use file word as standard output. If the file exists 
then output is appended (by seekinc to the end); 
otherwise the file is created. 

< < word 

The shell input is read up to a lire the same as wor d, 
or end of file. The resulting docuiment becomes the 
standard input. If any character cif word is quoted 
then no interpretation is placed ufon the characters of 
the document? otherwise, parameter and command 
substitution occurs, \newline is icnored, and \ is used 
to quote the characters \ $ ' and the first character 
of word . 

< S cdiqit 

The standard input is duplicated from file descriptor 
digit ? see dup (2). Similarly for the standard output 
using >. 

<&- The standard input is closed. Similarly for the 
standard output using >. 

If one of the above is preceded by a digit then the file 
descriptor created is that specified by the digit (instead 
of the default 0 or 1). For example, 

... 2>&1 

creates file descriptor 2 to be a duplicate of file 
descriptor 1. 

If a command is followed by & then the default standard 
input for the command is the empty file (/dev/null). 
Otherwise, the environment for the execution of a coimaand 
contains the file descriptors of the invoking shell as 
modified by input output specifications. 

Environment. 

The environment is a list of name-value pairs that is passed 
to an executed program in the same way as a normal.argument 
list? see exec(2) and environ(5). The shell interacts with 
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the environraent in several ways. On invocation, the shell 
scans the environment and creates a parameter for each name 
found, giving it the corresponding value. Executed commands 
inherit the same environment. If the user modifies the 
values of these parameters or creates new ones, none of 
these affects the environment unless the export command is 
used to bind the shell's parameter to the environment. The 
environment seen by any executed command is thus composed of 
any unmodified name-value pairs originally inherited by the 
shell, plus any modifications or additions, all of which 
must be noted in export commands. 

The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters . 

Thus these two lines are equivalent 

TERM=450 cmd args 

(export TERM; TSRM=450; cmd args) 

If the -k flag is set, all keyword arguments are placed in 

the environment, even if the occur after the command name. 

The following prints 'a=b c' and 'c'; 

echo a=b c 

set -k 

echo a=b c 

Signals. 

The irJTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals 
have the values inherited by the shell from its parent. 

(But see also trap.) 

Execution. 

Each time a command is executed the above substitutions are 
carried out. Except for the 'special commands' listed below 
a new process is created and an attempt is made to execute 
the command via an exec(2). 

The shell parameter $PATH defines the search path for the 
directory containing the command. Each alternative 
directory name is separated by a colon (;). The default 
path is :/bin:/usr/bin. If the command name contains a / 
then the search path is not used. Otherwise, each directory 
in the path is searched for an executable file. If the file 
has execute permission but is not an a. out file, it is 
assumed to be a file containing shell commands. A subshell 
(i.e., a separate process) is spawned to read it. A 
parenthesized command is also executed in a subshell. 


Special commands. 

The following commands are execiited in the shell process and 
except where specified no input output redirection is 
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permitted for such commands. 

: No effect; the command does nothing. 

• file 

Read and execute commands from fil s and return. Th(j 
search path $PATH is used to find the directory 
containing file , 
break Cn] 

Exit from the enclosing for or while loop, if any. If 
n is specified then break n levels, 
continue [n] 

Resume the next iteration of the enclosing for or while 
loop. If n is specified then resume at the n-th 
enclosing loop, 
cd C arg ] 

Change the current directory to The shell 

parameter $HOME is the default arg , 
eval C arg ...] 

The arguments are read as input to the shell and the 
resulting command(s) executed, 
exec C arg ...] 

The command specified by the arguments is executed d.n 
place of this shell without creating a new process. 
Input output arguments may appear and if no other 
arguments are given cause the shelJ. input output to be 
modified, 
exit Cn] 

Causes a non interactive shell to exit with the exit 
status specified by n. If n is omitted then the exit 
status is that of the last command executed. (An erd 
of file will also exit from the shell.) 
export Cname ...] 

The given names are marked for automatic export to the 
environment of subsequently-executeid commands. If no 
arguments are given then a list of exportable names is 
printed, 
login C arg ...] 

Equivalent to 'exec login arg ...'. 
newgrp C arg ...] 

Equivalent to 'exec newgrp arg ...'. 
read name ... 

One line is read from the standard input; successive 
words of the input are assigned to the variables name 
in order, with leftover words to the last variable. ~ 
The return code is .3 unless the end-of-file is 
encountered. 
readonly C name ...] 

The given names are marked readonly and the values of 
the these names may not be changed by subsequent 
assignment. If no arguments are given then a list of 
all readonly names is printed, 
set C-eknptuvx C arg ...]] 
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-e If non interactive then exit immediately if a 
command fails. 

“h All keyword arguments are placed in the environment 
for a command, not just those that precede the 
command name. 

-n Read commands but do not execute them. 

—t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 
-V Print shell input lines as they are read. 

“X Print commands and their arguments as they are 
executed. 

~ Turn off the —x and —v options. 

These flags can also be used upon invocation of the 
shell. The current set of flags may be found in 

Remaining arguments are positional parameters and are 
assigned, in order, to §1, $2, etc. If no arguments 
are given then the values of all names are printed. 

shift 

The positional parameters from $2... are renamed $1... 

times 

Print the accumulated user and system times for 
processes run from the shell. 

trap [ arg ] [n] ... 

is a command to be read and executed when the shell 
receives signal(s) n. (Note that arg is scanned once 
when the trap is set and once when the trap is taken.) 
Trap commands are executed in order of signal number. 

is absent then all trap(s) n are reset to their 
original values. If arg is the null string then this 
signal is ignored by the shell and by invoked commands. 
If n is 0 then the command arg is executed on exit from 
the shell, otherwise upon receipt of signal n as 
numbered in signal (2). Trap with no arguments prints a 
list of commands associated with each signal number. 

umask C nnn ] 

The user file creation mask is set to the octal value 
(see umas k (2)) . If nnn is omitted, the current 
value of the mask is isrinted. 

wait Cn] 

Wait for the specified process and report its 
termination status. If n is not given then all 
currently active child processes are waited for. The 
return code froin this command is that of the process 
waited for. 
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Invocation. 

If the first character of argument zero 
read from $H0ME/.profile, if such a filje 
are then read as described below. The 
interpreted by the shell when it is inv 
“C string If the -c flag is present 
from string . 

If the -s flag is present or 
remain then commands are rea 
input. Shell output is writ|: 
descriptor 2. 

If the -i flag is present or 
and outiJut are attached to a 
gtty ) then this shell is int^ 


is commands ate 
exists. Commands 
following flags are 
pked. 

n commands are rfead 


-s 


-1 


a 


case the terminate signal SKjjTERM (see signal 
is ignored (so that 'kill 0' 
interactive shell) and the i 
SIGINT is caught and ignored 
interruptable). In all case^ 
by the shell. 


does not kill an 
jiterrupt signal 
(so that wait is 
SIGQUIT is igno]|:ed 


The remaining flags and arguments are 
set command. 


described under the 


FILES 


$H0ME/.profile 
/tmp/sh* 

/dev/null 

SEE ALSO 

test(l), exec(2), 

DIAGNOSTICS 

Errors detected by the shell, such as s 
the shell to return a non zero exit stai 
being used non interactively then execu 
file is abandoned. Otherwise, the shel 
status of the last command executed (se^ 


BUGS 


If << is used to provide standard input 
process invoked by &, the shell gets mi 
the input document. A garbage file /tmi> 
the shell complains about not being abl€! 
another name. 


SH(1) 


if no argviments 
from the standat 
en to file 


if the shell inpht 
terminal (as tolg 
tractive. In this 


yntax errors causes 
us. If the shelJ. 
iion of the shell 
returns the exii 
also exit). 


to an asynchronous 
3j:ed up about narair.g 
/sh* is created, and 
to find the file by 


by 

2 )) 


IS 
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NAME 

size - size of an object file 


SYNOPSIS 

size C object ... ] 


DESCRIPTION 

Size prints the (decimal) number of bytes required by the 
text, data, and bss portions, and their sum in octal and 
decimal, of each object-file argument. If no file is 
specified, a.out is used. 


SEE ALSO 

a.out(5) 
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NAME 


sleep - suspend execution for an interval 


SYNOPSIS 

sleep time 


DESCRIPTION 

Sleep suspends execution for time seconc^ 
execute a command after a certain amouni: 

(sleep 105; command)& 

or to execute a command every so often. 


It is used to 
of time as in: 


as in: 


while true 
do 

command 
sleep 37 

done 


SEE ALSO 

alarm{2), sleep(3) 


BUGS 

Time must be less than 65536 seconds. 
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NAME 

sort - sort or merge files 
SYNOPSIS 

sort C -mubdfinrt x 3 C t posl C •• pos2 3 3 • • • C -O name 3 C 
-T directory 3 IT” name 3 • • • 

DESCRIPTION 

Sort sorts lines of all the named files together and writes 
the result on the standard output. The name means the 

standard input. If no input files are named, the standard 
input is sorted. 

The default sort key is an entire line. Default ordering is 
lexicographic by bytes in machine collating sequence. The 
ordering is affected globally by the following options, one 
or more of which may appear. 

b Ignore leading blanks (spaces and tabs) in field 
comparisons. 

d 'Dictionary' order: only letters, digits and blanks are 
significant in comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in 
nonnuraeric coiaparisons. 

n An initial numeric string, consisting of optional 

blanks, optional minus sign, and zero or more digits 
with optional decimal point-, is sorted by arithmetic 
value. Option n implies option b. 

r Reverse the sense of comparisons. 

tx 'Tab character' separating fields is x. 

The notation - fposl - pos2 restricts a sort key to a field 
beginning at posl and ending just before pos2 . Posl and 
pos2 each have the form m.n, optionally followed by one or 
more of the flags bdfinr, where ra tells a number of fields 
to skip from the beginning of the line and n tells a number 
of characters to skip further. If any flags are present 
they override all the global ordering options for this key. 
If the b option is in effect n is counted from the first 
nonblank in the field; b is attached independently to pos2 . 

A missing .n means .0; a missing - pos2 means the end of the 
line. Under the -tx option, fields are strings separated by 
x; otherwise fields are nonempty nonblank strings separated 
by blanks. 
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When there are multiple sort keys, latex keys are compare|d 
only after all earlier keys compare equal. Lines that 
otherwise compare equal are ordered witlj all bytes 
significant. 

These option arguments are also understood: 


c Check that the input file is sorted 
ordering rules; give no output unl^ 
of sort. 

m Merge only, the input files are air 

O The next argument is the name of an 
instead of the standard output. Th 
same as one of the inputs. 

T The next argument is the name of a 
temporary files should be made. 

u Suppress all but one in each set of 
Ignored bytes and bytes outside key 
in this comparison. 

Excunples. Print in alphabetical order al 
spellings in a list of words. Capitaliz 
uncapitalized. 

sort -u +0f +0 list 


SORT 


according to the 
ss the file is ou 


eady sorted. 

output file to use 
is file may be th 


directory in whic 


h 


equal lines, 
s do not participlate 


1 the unique 
bd words differ from 


Print the password file ( passwd (5)) sorted by user id number 
(the 3rd colon-separated field). 

sort -t; +2n /etc/passwd 

Print the first instance of each month ii an already sorted 
file of (month day) entries. The options -um with just one 
input file make the choice of a unique rspresentative from a 
set of equal lines predictable. 

sort -um +0 -1 dates 


FILES 

/usr/tmp/stm*, /tmp/*: first and second tries for temporar 
files 

SEE ALSO 

uniq(l), coram(l), rev(l), join(l) 

DIAGNOSTICS 

Comments and exits with nonzero status fbr various troubl^ 
conditions and for disorder discovered under option -c. 
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BUGS 

Very long lines are silently truncated. 
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NAME 

spell, spellin, spellout - find spelling errors 
SYNOPSIS 

spell C option ] ... [ file ] ... 

/src/cmd/spell/spellin C list ] 

DESCRIPTION 

Spell collects words from the named documents, and looks 
them up in a spelling list. Words that neither occur amoiig 
nor are derivable (by applying certain inflections, prefixes 
or suffixes) from words in the spelling list are printed on 
the standard output. If no files are named, words are 
collected from the standard input. 

Spell ignores most troff, tbl and eqn (l) constructions. 

Under the -v option, all words not literally in the spell;Lng 
list are printed, and plausible derivations from spelling 
list words are indicated. 

Under the -b option, British spelling is checked. Besides 
preferring centre , colour , speciality , t ravelled , etc., this 
option insists upon - ise in words like s tandarSHTse , Fowler 
and the OED to the contrary notwithstanding. 

The spelling list is based on many sources, and while mores 
haphazard than an ordinary dictionary, is also more 
effective in respect to proper names and popular technica], 
words. Coverage of the specialized vocabularies of biolocfy, 
medicine and chemistry is light. 

Pertinent auxiliary files may be specified by name 
arguments, indicated below with their deJfault settings. 
Copies of all output are accumulated in the history file. 

The stop list filters out misspellings (e.g. 
thier=thy-y+ier) that would otherwise pasts. 

Spellin augments the hash list used by 3T:>ell . It expects a 
list of words, one per line, from the stc.ndard input. 

Spellin adds the words on the standard irput to the 
preexisting list and places a new list or. the standard 
output. If no list is specified, the new list is created 
from scratch. 

FILES 

D=/usr/dict/hlistCab]; hashed spelling lists, American & 
British 

S=/usr/dict/hstop: hashed stop list 
H=/usr/dict/spellhist; history file 
/usr/lib/spell 
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BUGS 


deroff(l), sort(l), tee{l), sed{l) 


The spelling list's coverage is uneven; new installations 
will probably wish to monitor the output for several months 

to gather local additions. 

British spelling was done by an American. 
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NAME 


spline - interpolate smooth curve 


SYNOPSIS 

spline C option 3 

DESCRIPTION j 

Spline takes pairs of numbers from the standard input as 
abci^as and ordinates of a function. it produces a simii 
set, <vhich is approximately equally spaced and includes 
input set, on the standard output. The tubic spline outpilit 
(R. W. Hamming, Numerical Methods for Scientists and 


SPLINE(IG) 


Engineers, 2nd ed., 349ff) has two contijiuous derivatives 
and sufficiently many points to look smojith when plotted, 
for example by graph (1). 

The following options are recognized, eaj^h as a separate 
argument. 


-a Supply abscissas automatically (the^ 
the input); spacing is given by the 
is assumed to be 1 if next argument 


-k The constant k used in the boundary 


(2nd deriv. at end) = k*(2nd der 


iv. next to end) 


is set by the next argument. By de 


-n 


“P 


-X 


Space output points so that approxi 
occur between the lower and upper jd 
= 100 .) 


fault k = 0. 

jraately n interval 
limits. (Default 


Make output periodic, i.e. match de 
First and last input values should 


Next 1 (or 2) arguments are lower 
Normally these limits are calculate 


Automatic abcissas start at lower l| 

SEE ALSO 

graph(1) 

DIAGNOSTICS 

When data is not strictly monotone in x, 
the input without Interpolating extra pci 


BUGS 


A limit of 1000 input points is enforced silently 


are missing from 
next argument, of 
is not a number. 

value computation 


rivatives at ends 
normally agree. 


(jand upper) x limi 
d from the data, 
imit (default 0). 


spline reproduce] 
ints. 


ar 

e 


n 


ts. 
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NAME 

split - split a file into pieces 


SYNOPSIS 

split C -n ] 


C file C name ] 


3 


DESCRIPTION 

Solit reads file and writes it in n-line pieces J^^efault 
1^00), as many as necessary, onto a set of outi>ut rues. 

The name of the first output file is name with aa appended, 
and so on lexicographically. If no output name is given, x 

is' default. 


If no input file is given, or if - is given in its stead, 
then the standard input file is used. 
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NAME 


strip “ remove symbols and relocation t' 


SYNOPSIS 

strip name ... 

DESCRIPTION , ^ , I 

Strip removes the symbol table and reloccL 
ordinarily attached to the output of the 
loader. This is useful to save space aft. 
been debugged. 


The effect of strip is the same as use 
Id. 


of the -s option oi: 


FILES 


/tmp/stm? temporary file 


SEE ALSO 

ld(l) 


STRIP(1) 


its 


tion bits 
assembler and 
er a program has 
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NAME 


stty - set terminal options 


SYNOPSIS 

stty C option ... J 

DESCRIPTION^tg certain l/O options on the current output 

terminal. With no argument, it reports ^^^®5rom^the”^^ 

of the options. The option strings are selected from the 

following set; 


allow even parity 
disallow even parity 
allow odd parity 

disallow odd parity _ 

raw mode input (no erase, kill, interrupt, quit, 

EOT; parity bit passed back) 
negate raw mode 
same as '-raw' 

make each character available to re a d(2) as 
received; no erase and kill _ 

make characters available to read only when newline 

is received 

allow carriage return for new-line, and output CR-LF 
for carriage return or new-line 
accept only new-line to end lines 
echo back every character typed 
do not echo characters 
map upper case to lower case 
do not map case 

replace tabs by spaces when printing 

preserve tabs , , . i 

reset erase and kill characters back to normal # and 

@ 

set erase character to c (default^ 
set kill character to c (default @ .) 
set interrupt character to c (default DEL .) 
set quit character to £ (default control \.) 
set start character to c (default control Q.) 
set stop character to c (default control S.) . 

set end of file character to c (default control p.j 
set break character to c (default undefined.) This 
character is an extra wakeup causing character. 

select style of delay for carriage return (see 
ioctl (2)) 

nl0 nil nl2 nl3 , . \c ^ 

selGCt style of delay for linefeed 

tab0 tabl tab2 tab3 

select style of delay for tab 
ff0 ffl select style of delay for form feed 


even 
-even 
odd 
-odd 
raw 

-raw 

cooked 

cbreak 

-cbreak 

-nl 

nl 

echo 

-echo 

lease 

-lease 

-tabs 

tabs 

ek 

erase £ 
kill c 
intr c 
quit £ 
start £ 
stop £ 
eof £ 
brk c 
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bs0 bsl select style of delay for backspace 

tty33 set all modes suitable for the Teletype Corporation 
Model 33 terminal. 

tty37 set all modes suitable for the Teletype Corporation 
Model 37 terminal. 

vt05 set all modes suitable for Digital Equipment Cor;?. 

VT05 terminal 

tn300 set all modes suitable for a General Electric 
TerraiNet 300 

ti700 set all modes suitable for Texas Instruments 700 
series terminal 

tek set all modes suitable for Tektronix 4014 terminal 

hup hang up dataphone on last close. 

-hup do not hang up dataphone on last close. 

0 hang up phone line immediately 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 
Set terminal baud rate to the number given, if 
possible. (These are the speeds supported by the 
DH-11 interface). 

SEE ALSO 

ioctl(2), tabs(l), tset(l), stty(l) 
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NAME 

su - substitute user id temporarily 


SYNOPSIS 

su [ userid ] 


DESCRIPTION 

Su demands the password of the specified userid , and if it 
is given, changes to that userid and invokes the Shell sh(1) 
without changing the current directory or the user 
environment (see environ (5)). The new user ID stays in 
force until the Shell exits. 


If no userid is specified, 'root* is assumed. To remind the 
super-user of his responsibilities, the Shell substitutes 
'#' for its usual prompt. 


SEE ALSO 

shd) 


Page 1 


(printed 8/22/83) 



SUM(l) 


Nu Machine UNIX Programmer's Manual 


SUM(l) 


NAME 

sura - sum and count blocks in a file 

SYNOPSIS 

sxim file 


DESCRIPTION 

Sura calculates and prints a 16-bit check 
file, and also prints the nuraber of bloc 
is typically used to look for bad spots, 
file coraraunicated over some transmission 


sum for the named 
ks in the file. lit 
or to validate a 
line. 


SEE ALSO 

wc (1) 


DIAGNOSTICS 

'Read error' is indistinuishable 
devices; check the block count. 


from end of file on most 


m) 
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NAME 

sync - update the super block 

SYNOPSIS 

sync 

DESCRIPTION 

Sync executes the sync system primitive. If the system is 
to be stopped, sync must be called to insure file system 
integrity. It will flush all previously unwritten system 
buffers out to disk, thus assuring that all file 
modifications up to that point will be saved. See sync (2) 
for details. 


SEE ALSO 

sync(2). 
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NAME 

tail - deliver the last part of a file 


SYNOPSIS 

tail tnumberC lbc ] C file ] 


DESCRIPTION 


Tail copies the named file to the standard output beginni 
at a designated place. If no file is named, the standard 
input is used. 


hg 


Copying begins at distance + number from 
- number from the end of the input. Numb 
units of lines, blocks or characters, ac 
appended option 1, b or c. When no units 
counting is by lines. 


the beginning, or 
er is counted in 
cording to the 
are specified. 


SEE ALSO 

dd(l) 


BUGS 


Tails relative to the end of the file ar 
buffer, and thus are limited in length, 
anomalous behavior may happen with chara 


e treasured up in 
Various kinds of 
cter special filels 
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NAME 

tar - tape archiver 
SYNOPSIS 

tar C Tcey ] C name ... ] 

DESCRIPTION 

Tar saves and restores files on magtape. Its actions are 
controlled by the hey argument. The key is a string of 
characters containing at most one function letter and 
possibly one or more function modifiers. Other arguments to 
the command are file or directory names specifying which 
files are to be dumped or restored. In all cases, 
appearance of a directory name refers to the files and 
(recursively) subdirectories of that directory. 

The function portion of the key is specified by one of the 
following letters; 

r The named files are written on the end of the tape. 

The c function implies this. 

X The neuned files are extracted from the tape. If the 

neuned file matches a directory whose contents had 
been written onto the tape, this directory is 
(recursively) extracted. The owner arid mode are 
restored (if possible). If no file argument is 
given, the entire content of the tape is extracted. 
Note that if multiple entries specifying the same 
file are on the tape, the last one overwrites all 
earlier. 

t The names of the specified files are listed each 

time they occur on the tape. If no file argument is 
given, all of the names on the tape are listed. 

u The named files are added to the tape if either they 

are not already there or have been modified since 
last put on the tape. 

c Create a new tape; writing begins on the beginning 

of the tape instead of after the last file. This 
command implies r. 

The following characters may be used in addition to the 
letter which selects the function desired. 

0,...,7 This modifier selects the drive on which the tape 
is mounted. The default is 1. 

V Normally tar does its work silently. The v 

(verbose) option causes it to type the name of 
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each file it treats preceded l>y the function 
letter. With the t function, v gives more 
information about the tape entries than just tte 
name. 

w causes tar to print the actiori to be taken 

followed by file name, then we.it for user 
confirmation. If a word beginning with 'y' is 
given, the action is perforraec,. Any other input 
means don't do it. 

f causes tar to use the next argument as the name of 

the archive instead of /dev/mt?. If the name of 
the file is tar writes to standard output or 

reads from standard input, whichever is 
appropriate. Thus, tar can be used as the head or 
tail of a filter chain Tar can also be used to 
move hierarchies with the command 

cd fromdir; tar cf - . | (cd todir; tar xf -) 

b causes tar to use the next argument as the 

blocking factor for tape records. The default is 
1, the maximum is 20. This option should only bs 
used with raw magnetic tape archives (See f 
above). 

1 tells tar to complain if it cannot resolve all of 

the links to the files dumped. If this is not 
specified, no error messages are printed. 

p when used with x (extract), tells tar to preserve 

the ownership and mode bits of each file. 

FILES 

/dev/rat? 

/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write 
errors. 

Complaints if enough memory is not available to hold the 
link tables. 

BUGS 

There is no way to ask for the n-th occuirrence of a file. 
Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are goj.ng 
to be updated. The current magtape driver cannot backspace 
raw magtape. If the archive is on a disl: file the b option 
should not be used at all, as updating an archive stored i.n 
this manner can destroy it. 
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The current limit on file ncune length is 100 characters. 
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NAME 

tbl - format tables for nroff or troff 
SYNOPSIS 

tbl C files ] ... 

DESCRIPTION 

Tbl is a preprocessor for formatting tables for nroff or 
troff(1). The input files are copied to the standard 
output, except for lines between .TS and .TE command lines, 
which are assumed to describe tables and reformatted. 
Details are given in the reference manuctl. 

As an example, letting \t represent a teib (which should te 
typed as a genuine tab) the input 

.TS 

css 

CCS 

c c c 
Inn. 

Household Population 
Town\tHouseholds 
\tNumber\tSize 
Bedminster\t789\t3.26 
Bernards Twp.\t3087\t3i74 
Bernardsville\t2018\t3.30 
Bound BrooTc\t3425\t3.04 
Branchburg\tl644\t3.49 
Bridgewater\t7897\t3.81 
Far Hills\t240\t3.19 
.TE 

yields 


Household Population 
Town Households 

Number Size 
Bedminster 789 3.26 

Bernards Twp. 3087 3.74 

Bernardsville 2018 3.30 

Bound Brook 3425 3.04 

Branchburg 1644 3.49 

Bridgewater 7897 3.81 

Far Hills 240 3.19 

If no arguments are given, tbl reads the standard input, so 
it may be used as a filter. When it is used with eqn or 
neqn the tbl command should be first, tc minimize the volume 
of data passed through pipes. 
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SEE ALSO 

troff(l), eqn(l) 
M. E. Lesk, TBL. 
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NAME 


tee - pipe fitting 


SYNOPSIS 

tee C -i ] C -a ] C file 3 ... 

DESCRIPTION 

Tee transcribes the standard input to t:^e standard output, 
and^malces copies in the files . Option *“1 ignores interru^its; 
option -a causes the output to be appended to the fil es 
rather than overwriting them. 


TEE(l) 
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NAME 

test - condition command 

SYNOPSIS 

test expr 

DESCRIPTION 

test evaluates the expression expr / and if its value is true 
then returns zero exit status; otherwise, a non zero exit 
status is returned, test returns a non zero exit if there 
are no arguments. 


The following primitives are used to construct expr . 


-r 

file 

true 

if 

the 

file 

exists 

and 

is 

readable. 

-w 

file 

true 

if 

the 

file 

exists 

and 

is 

writable. 

-f 

file 

true 

if 

the 

file 

exists 

and 

is 

not a directory. 

-d 

file 

true 

if 

the 

file 

exists 

and 

is 

a directory. 

-s 

file 

true 

if 

the 

file 

exists 

and 

has 

1 a size greater than 


zero. 

-t C fildes ] 

true if the open file whose file descriptor number 
is fildes (1 by default) is associated with a 
terminaldevice. 

-z si true if the length of string s^ is zero. 

-n si true if the length of the string sl^ is nonzero, 

si = s2 true if the strings £1^ and s^ are equal, 

si 1= s2 true if the strings and ^ are not equal, 

si true if sj^ is not the null string, 

nl -eq n2 

true if the integers nl and n^ are algebraically 
equal. Any of the comparisons -ne, -gt, -ge, -It, 
or -le may be used in place of -eq. 

These primaries may be combined with the following 
operators; 

1 unary negation operator 
-a binary and operator 
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-o binary or operator 
( expr ) 

parentheses for grouping. 

-a has higher precedence than -o. Notice that all the 
operators and flags are separate arguments to test . Not;.ce 
also that parentheses are meaningful to the Shell and must 
be escaped. 

SEE ALSO 

shd), find(l) 
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NAME 

time - time a command 

SYNOPSIS 

time command 


DESCRIPTION 

The given command is executed; after it is complete, time 
prints the elapsed time during the command, the time spent 
in the system, and the time spent in execution of the 
command. Times are reported in seconds. 

The execution time can depend on what kind of memory the 
progreim happens to land in; the user time in MOS is often 
half what it is in core. 

The times are printed on the diagnostic output stream. 


BUGS 

Elapsed time is accurate to the second, while the CPU times 
are measured to the 60th second. Thus the sum of the CPU 
times can be up to a second larger than the elapsed time. 
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NAME 


tip - connect to a remote system 


SYNOPSIS 

tip C -V 3 C -speed ] system-name 
DESCRIPTION 

Tip establishes a full-duplex connectior. to another machine, 
giving the appearance of being logged in directly on the 
remote cpu. It goes without saying that you must have a 
login on the machine (or equivalent) to which you wish to 
connect. 

Typed characters are normally transmitted directly to the 
remote machine (which does the echoing as well). A tilde 
(''~'') appearing as the first character of a line is an 
escape signal; the following are recognized: 

or Drop the connection and exit (you may still- be 
logged in on the remote machine). 

~c [name] Change directory to name (no argument implies 
change to your home directory). 

~i Escape to a shell (exiting the shell will return 

you to tip). 

“> Copy file from local to remote. 

~< Copy file from remote to local. 

~p from Lto3 

Send a file to a remote UNIX host. The put 
command causes the remote UNIX system to run the 
command string "cat > 'to*'', while tip sends it 
the ''from'' ^file. If the "to*' file isn't 
specified the "from'' file name is used. Tiis 
command is actually a UNIX specific version of the 
" ~ '' command. 


't from [to] 

Take a file from a remote UNIX host. As in the 
put command the "to'' file defaults to the 
"from'', file name if it isn't specified. The 
remote host executes the command string ''cat 
'from'recho ^A'' to send the file to tip. 

' 1 Pipe the output from a remote command to a local 

UNIX process. The command string sent to the 
local UNIX system is processed by the shell. 


Send a BREAK to the remote system. 


For systems 
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which don't support the necessary loctl call the 
break is simulated by a sequence of line speed 
changes and DEL characters. 

"s Set a variable (see the discussion below). 

~'‘Z Stop tip (only available with job control). 

Get a summary of the tilde escapes 


Copying files requires some cooperation on the part of the 
remote host. When a ~> or ~< escape is used to send a file, 
tip will prompt for a file name (to be transmitted or 
received) and a command which will be sent to the remote 
system, in case the file is being transferred from the 
remote system. The default end of transmission string for 
transferring a file from the local system to the remote is 
specified in the remote (5) file, but may be changed by the 
set command. While tip is transferring a file the number of 
lines transferred will be continuously displayed on the 
screen. A file transfer may be aborted with an interrupt. 
An example of the dialogue used to transfer files is given 
below. 

% tip mds 
[connected] 

<<Assume we are talking to another UNIX systera>> 

login: ken 

Password: 

% cat > foo.c 
~> Filename: foo.c 

32 lines transferred in 1 minute 3 seconds 
% 

% ~< Filename: reply.c 

List command for remote host: cat reply.c 
65 lines transferred in 2 minutes 
% 

<<0r, equivalently>> 

% ~p foo.c 

<<actually echo's as “[put] foo.c>> 

32 lines transferred in 1 minute 3 seconds 

% 

% ~t reply.c 

<<actually echo's as “[take] reply.c>> 

65 lines transferred in 2 minutes 
% 

<<To print a remote file locally>> 
o “ILocal command; pr -h foo.c 1 Ipr 
List command for remote host; cat foo.c 
% “^D 
[EOT] 
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<<Back on the local system>> 
% 


Tip can be used to connect to the sdu of a Nu Machine. If 
the sdu operating system is running (and not UNIX), then the 
only escape sequences that can be used are the local ones 
and sending a break to the sdu. The ttf driver in the sdu 
operating system sends escape sequences to tip to access 
files on the local system. 

The remote (5) file contains the definitions for all remote 
systems known by tip ; refer to the remote manual page for a 
full description. In particular, each system-name has a 
default baud rate with which to establish a connection. If 
this value is not suitable, the baud rate to be used may be 
specified on the command line, e.g. ''tip -300 mds*'. 

When tip establishes a connection it sends out a conneci:ion 
message to the remote system. The default value for this 
string may be found in the remote file. 

At any time that tip prompts for an argument (e.g. during 
set-up of a file transfer) the line typed may be edited with 
the standard erase and kill characters. A null line in 
response to a prompt, or an interrupt, will abort the 
dialogue and return you to the remote machine. 

When tip attempts to connect to a remote system, it ojsens 
the associated device with an exclusive-open ioctl (2) call. 
Thus only one user at a time may access a device. This is 
to prevent multiple processes from sampling the terminal 
line. In addition, tip honors the locking protocol used by 
uucp (l). 

AUTO-CALL UNITS 

Tip may be used to dial up remote systems using a number of 
auto-call unit’s (ACU's). T'flien the remote system 
description contains the "du* ' attribute, tip will use the 
call-unit ("cu'*), ACU type ("at’’), and phone numbers 
("pn’’) supplied. Normally tip will print out the verbose 
messages as it dials. See remote ( 5 ) for details of the 
remote host specification. 

Depending on the type of auto-dialer being used to establish 
a connection the remote host may have garbage charac;ers 
sent to it upon connection. The user should never assume 
that the first characters typed to the foreign host are the 
first ones presented to it. The recommended practice is to 
immediately type a ''kill*' character upon establishing a 
connection (most UNIX systems support ' as the initial 
kill character). 
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Tip currently supports DEC's DN-11 interface with Bell 801 
or Vadic 821 callers, DEC's DP02-AC and DF03-AC, Bizcomp's 
1031 and 1022 intelligent modems, Ventel's autodialer 
modems, and Vadic VA3450 modem. 

REMOTE HOST DESCRIPTIONS 

Descriptions of remote hosts are normally located in the 
system-wide file / etc / remote . However, a user may maintain 
personal description files (and phone numbers) by defining 
and exporting the shell variable REMOTE. The remote file 
must be readable by tip, but a secondary file describing 
phone numbers may be maintained readable only by the user. 
This secondary phone number file defaults to / etc / phones , 
unless the shell variable PHONES is defined and exported. 
As described in remote (5), the phones file is read when the 
host description's pione number(s) capability is an 
The phone number file contains lines of the form: 

system-name phone-number 

Each phone number found for a system is tried until either a 
connection is established, or an end of file is reached. 
Phone numbers are constructed from "0123456789-=*”, where 
the " = '' and "*'• are used to indicate a second dial tone 
should be waited for (ACU dependent). 

VARIABLES 

Tip maintains a set of variables which are used in normal 
operation. Some of these variable are read-only to normal 
users (root is allowed to change anything of interest). 
Variables may be displayed and set through the "s'" escape. 
The syntax for variables is patterned after the ^(1) editor 
and the mail (l) system. Supplying ''all'' as an argument to 
the set command displays all variables readable by the user. 
Alternatively, the user may request display of a particular 
variable by attaching a "?'• to the end. For example 
"escape?'' would display the current escape character. 

Variables are numeric, string, character, or boolean values. 
Boolean variables are set merely by specifying their name. 
They may be reset by prepending a "i*' to the name. Other 
variable types are set by appending an " = '' and the value. 
The entire assignment must not have any blanks in it. A 
single set command may be used to interrogate as well as set 
a number of variables. Variables may be initialized at run 
time by placing set commands (without the "~s'' prefix in a 
file . tiprc in one's home directory). The -v option causes 
tip to display the sets as they are made. 

Finally, the variable names must either be completely 
.si>ecified or an abbreviation may be given. The following 
list details those variables known to tip , their 
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abbreviations (surrounded by bracket^ 
values. Those variables Initialized froi 
are marked with a a mode is give 
capitalization indicates the read or w 
given only to the super-user. 


Name 

Type 

Mode 

CbeHautify 

bool 

rw 

[baHudrate 

num 

rW 

Cdial]timeout 

num 

rW 

Ceofr]ead 

str 

rw 

Ceofw3rite 

str 

rw 

CeolD 

str 

rw 

Ceslcape 

char 

rw 

[exHceptions 

str 

rw 

Cfo]rce 

char 

rw 

Cfr]araesize 

num 

rw 

[ho]St 

str 

r 

Clock] 

str 

RW 

Clog] 

str 

RW 

Cphones] 

str 

r 

Cpr]orapt 

char 

rW 

Cra]ise 

bool 

rw 

Cr]aiseCc]har 

char 

rw 

Crec]ord 

str 

rw 

Cremote] 

str 

r 

Csc]ript 

bool 

rw 

Ctab]expand 

bool 

rw 

Cverb]ose 

bool 

rw 

CSHELL] 

str 

rw 

Chome] 

str 

rw 

NOTE: 1. s.d 

. indicates 


Default 

true 


* 

60 


* 

* 


\ e# I 

"\t\n\f\b" 
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), and their defa 
fm the remote f 
n for each variabi 
rite capability 


ult 

lie 

ley 

is 


es 


* 


s.d. 

Sod. 

s.d. 

'\n' 

false 


Description 
discard unprintabl] 
when scripting 
onnection baud ral 
imeout (seconds) 

I tablishing conne 
ar‘s signifying 
om the remote ho| 
ring sent for EO 
ar's signifying 
romand prefix cha 
ar's not discard 
e to beautificat 
rces transparenc 
ze of buffering 
ites on receptio^ 
me of host conne 
ibck file for ACU 
Apu log file 

ile for hidden phbne numl 


te 

when 

ction 

EOT 

St 

r 

an end 
racter 
ed 
ion 

y on ne 
between 


cted to 
Logging 


end of line indicator set 


upper case mapping 


"tip.record 
s.d. 
false 
false 
true 

"/bin/sh" 


nteractive toggle 
"name of script out 
ystem description 
ession scripting 
xpand tabs during 
make noise during 
ame of shell for 
ome directory for 


__ _ the default 

dependent; normally these values are 


log=»/usr/adm/aculog, 
remote=/etc/remote. 


phones*/etc 


value is sys 
lock*/tmp/aculoj:: 
l/phones. 


ENVIRONMENT VARIABLES 

The following variables are read from thi 


REMOTE 


The location of the remote fil 


PHONES 


The location of the file contaj 
numbers. 


HOST 


A default host to connect to. 


switch 
for raise 
^ut file 
file 
bwitch 
file transfe 
Ifile transfer 
i escape 
“c escape 


e environment! 

e. 


ining private ph 


bf lin 


xt cha 


m 

by he 


tern 

Ik, 

knd 


one 
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FILES 


HOME One's log-in directory (for chdirs). 

SHELL The shell to fork on a ~l escape. 

~/.tiprc Variable initialization file. 


/usr/spool/uucp/LCK..* Lock file to avoid conflicts with 

uucp. Terminated with port name. 


DIAGNOSTICS 

unrecognizable host ncune 

The phone number file is malformed. 

missing phone number 

A line in the phone number file is incomplete; or the 
remote host description indicates the host should be 
called, but no phone number is specified. 

taizcomp out of sync 

When using a BIZCOMP ACU the dialer must be "synced'* 
up before tip will attempt to place a call. Try 
running tip again. 

missing device spec 

The remote host description entry is missing a device 
specification. 

tiraedout at eol n 

During a file transfer tip has lost contact with the 
remote system while waiting for a synchronizing echo. 

timeout error 

Same as above. 

Other diagnostics are, hopefully, self explanatory. 

SEE ALSO 

remote(5) 
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NAME 


• I 

touch - update date last modified of a rile 


SYNOPSIS 

touch C -c ] file ... 

DESCRIPTION 

Touch attempts to set the modified date 
is done by reading a character from the 
back. 


If a file does not exist, an attempt wi][l be made to create 
it unless the -c option is specified. 


TOUCH(l) 


of each file . This 
file and writing it 
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NAME 

tr - translate characters 
SYNOPSIS 

tr C -cds ] C stringl C string2 ] ] 

DESCRIPTION 

Tr copies the standard input to the standard output with 
substitution or deletion of selected characters. Input 
characters found in stringl are mapped into the 
corresponding characters of string2 . When string2 is short 
it is padded to the length of stringl by duplicating its 
last character. Any combination of the options -cds may be 
used; -c complements the set of characters in stringl with 
respect to the universe of characters whose ASCII codes are 
01 through 0377 octal; —d deletes all input characters in 
stringl ; -s squeezes all strings of repeated output 
characters that are in string2 to single characters. 

In either string the notation a-b means a range of 
characters^from a to b in increasing ASCII order. The 
character '\' followed by 1, 2 or 3 octal digits stands for 
the character whose ASCII code is given by those digits. A 
'\' followed by any other character stands for that 
character. 

The following example creates a list of all the words in 
'filel' one per line in 'file2', where a v/ord is taken to be 
a maximal string of alphabetics. The second string is 
quoted to protect '\' from the Shell. 012 is the ASCII code 
for newline. 

tr -cs A-Za-z '\012' <filel >file2 


SEE ALSO 

ed(l), ascii(7) 


BUGS 

Won’t handle ASCII NUL in stringl or string2 ; always deletes 
NUL from input. 
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NAME 

true, false - provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True does nothing, successfully. False does nothing, 
unsuccessfully. They are typically used in input to sh(:i) 
such as: 

while true 
do 

command 

done 

SEE ALSO 

sh{l) 

DIAGNOSTICS 

True has exit status zero, false nonzero. 


Page 1 


(printed 8/22/83) 




TSORT(l) 


Nu Machine UNIX Programmer's Manual 


TSORT(l) 


NAME 

tsort - topological sort 

SYNOPSIS 

tsort C file ] 


DESCRIPTION 

Tsort produces on the standard output a totally ordered list 
of items consistent with a partial ordering of items 
mentioned in the input file . If no file is specified, the 
standard input is understood. 


The input consists of pairs of items (nonempty strings) 
separated by blanks. Pairs of different items indicate 
ordering. Pairs of identical items indicate presence, but 
not ordering. 

SEE ALSO 

lorder(l) 


DIAGNOSTICS 

Odd data: there is an odd number of fields in the input 
file. 


BUGS 

Uses a quadratic algorithm; not worth fixing for the typical 
use of ordering a library archive file. 
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NAME 

tty - get terminal naune 


SYNOPSIS 

tty 


DESCRIPTION 

Tty prints the pathname of the user's terminal. 
DIAGNOSTICS 

'not a tty* if the standard input file is not a terminal. 
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NAME 

ul - do underlining 
SYNOPSIS 

ul C -t terminal ] [ name ... ] 


DESCRIPTION 

Ul reads the naimed files (or standard input if none are 
^ven) and translates occurrences of underscores to the 
sequence which indicates underlining. If -t is present, 
terminal is used as the terminal kind. Otherwise, the 
environment is looked in and / etc / termcap read to determine 
the appropriate sequences for underlining. If none of the 
fields us, ue, or uc is present, and if so and se are 
present, standout mode is used to indicate underlining. If 
the terminal can overstrike, or handles underlining 
automatically, ul behaves like cat (1). If the terminal 
cannot underline, underlining is ignored. 


SEE ALSO 

iul(l), man(l), nroff{l) 


AUTHOR 

Mark Horton 


BUGS 

Nroff usually outputs a series of backspaces and underlines 
intermixed with the text to indicate underlining. No 
attempt is made to optimize the backward motion. 
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NAME 

umount. - file system dismount 

SEE 

mount(1) 
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NAME 

unget - undo a previous get of an SCCS file 
SYNOPSIS 

unget C-rSID] C-s] C-n] files 
DESCRIPTION 

Unget undoes the effect of a get -e done prior to creating 
the intended new delta. If a directory is named, unget 
behaves as though each file in the directory were specified 
as a named file, except that non-SCCS files and unreadable 
files are silently ignored. If a name of - is given, the 
standard input is read with each line being taken as the 
name of an SCCS file to be processed. 

Keyletter arguments apply independently to each named file. 

- rSID Uniquely identifies which delta is no 

longer intended. (This would have been 
specified by get as the "new delta''). 

The use of this keyletter is necessary only 
if two or more outstanding gets for editing 
on the same SCCS file were done by the same 
person (login name). A diagnostic results 
if the specified SID is ambiguous, or if it 
is necessary and omitted on the command 
line. 

-s Suppresses the printout, on the standard 

output, of the intended delta's SID . 

-n Causes the retention of the gotten file 

which would normally be removed from the 
current directory. 

SEE ALSO 

delta(l), get(l), sact(l). 

DIAGNOSTICS 

Use help d) for explanations. 
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NAME 


uniq - report repeated lines in a file 


SYNOPSIS 

uniq C —udc C +n ] [ -n ] ] [ input [ ouj:put 3 3 
DESCRIPTION 

Uniq reads the input file comparing adjac 
normal case, the second and succeeding co 
lines are removed; the remainder is writ^ 
file. Note that repeated lines must be 
be found; see sort (1). If the -u flag i^ 
lines that are not repeated in the origi 
The —d option specifies that one copy of 
lines is to be written. The normal mode 
of the -u and -d mode outputs. 


The -c option supersedes -u and -d and g^ 
report in default style but with each liri 
count of the number of times it occurred.! 


The n arguments specify skipping an initi 
line in the comparison: ' 


-n 


The first n fields together with 
each are ignored. A field is de:d 
non-space, non-tab characters se 
spaces from its neighbors. 


+n 


UNIQ 


tl) 


the 


ent lines. In 
pies of repeated 
en on the output 
Adjacent in order 
used, just the 
r|ial file are outpii 
just the repeated 
output is the uni 


^nerates an outputj 
e preceded by a 


to 

t. 

on 


al portion of each 


any blanks before 
ined as a string of 
iriarated by tabs ana 


The first n characters are ignorejd. 
skipped before characters. 


SEE ALSO 

sort(l), comm(l) 


Fields are 
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NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Units converts quantities expressed in various standard 
scales to their equivalents in other scales. It works 
interactively in this fashion; 

You have ; inch 
You want: cm 

* 2.54000e+00 
/ 3. 93701e- 01 

A quantity is specified as a multiplicative combination of 
units optionally preceded by a numeric multiplier. Powers 
are indicated by suffixed positive integers, division by the 
usual sign: 

You have ; 15 pounds force/in2 
You want; atm 

* 1.02069e+00 
/ 9*797306-01 

Units only does multiplicative scale changes. Thus it can 
convert Kelvin to Rankine, but not Centigrade to Fahrenheit. 
Most familiar units, abbreviations, and metric prefixes are 
recognized, together with a generous leavening of exotica 
and a few constants of nature including; 

pi ratio of circumference to diameter 

c speed of light 

e charge on an electron 

g acceleration of gravity 

force same as g 
mole Avogadro's number 

water pressure head per unit height of water 
au astronomical unit 

'Pound' is a unit of mass. Compound names are run together, 
e.g. 'lightyear'. British units that differ from their US 
counterparts are prefixed thus; 'brgallon'. Currency is 
denoted 'belgiumfranc', 'britainpound', ... 

For a complete list of units, 'cat /usr/lib/units*. 


FILES 

/usr/lib/units 

BUGS 
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NAME 

uucp/ uulog - Unix to unix copy 
SYNOPSIS 

uucp C option ] ... source-file ... destination-file 
uulog C option ] ... 

DESCRIPTION 

Uucp copies files neimed by the source-file arguments to the 
destination-file argument. A file,name may be a path name 
on your machine, or may have the form 

system-name Ipathname 

where 'system-name* is taken from a list of system names 
which UUCP knows about. Shell metacharacters ?*£] appearing 
in the pathname part will be expanded on the appropriate 
system. 

Pathnames may be one of 

(1) a ful1 pathname; 

(2) a pathname preceded by “ user ; where user is a userid on 
the specified system and is replaced by that user's 
login directory; 

(3) anything else is prefixed by the current directory. 

If the result is an erroneous pathname for the remote system 
the copy will fail. If the destination-file is a directory, 
the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission 
and gives 0666 read and write permissions (see chmod (2)). 

The following options are interpreted by uucp . 

-d Make all necessary directories for the file copy. 

-c Use the source file when copying out rather than 
copying the file to the spool directory. 

-m Send mail to the requester when the copy is complete. 

Uulog maintains a summary log of uucp and uux (l) 
transactions in the file ' /usr/spool/uucp/LOGFIt,E' by 
gathering information from partial log files named 
'/usr/spool/uucp/LOG.*.?*. It removes the partial log 
files. 
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The options cause uulog to print logging information: 


-s sys 

Print information about work invol 
-u user 

Print information about work done 
user. 


ving system sys . 


for the specified 


FILES 


/usr/spool/uucp - spool directory 
/usr/lib/uucp/* - other data and prograjn 


SEE ALSO 

uux(l), mail(l) 

D. A. Nowitz, Uucp 


Implementation Description 


WARNING 

The domain of remotely accessible files 
security reasons, usually should) be se 
You will very likely not be able to fetj: 
ask a responsible person on the remote 
to you. For the same reasons you will 
to send files to arbitrary pathnames. 


BUGS 


All files received by uucp will be owned 
The -m option will only work sending fi^ 
single file. (Receiving multiple files 
shell characters ?*[] will not activate 


UUCP 


files 


can (and for obvious 
Merely restricted 
ih files by pathname; 
^ystem to send thorn 
probably not be able 


by uucp. 
es or receiving 
specified by spectial 
the -m option.) 


(1C) 
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NAME 

uulog ~ Unix to unix copy 

SEE 

UUCP(1) 
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NAME 


uux - Unix to Unix command execution 


SYNOPSIS 

uux C - ] command-string 

DESCRIPTION 

Uux will gather 0 or more files from var| 
execute a command on a specified system 
output to a file on a specified system. 


UUX(1C) 


ious systems, 
land send standard 


The command-string is made up of one or more arguments that 
look like a shell command line, except that the command aid 
file names may be prefixed by system-name I. A null system- 
name is interpreted as the local system. 

File names may be one of 

(1) a full pathname; 


(2) a pathname preceded by ** xxx ; where xxx is a user 
on the specified system and is replaced by that user 
login directory; 


(3) anything else is prefixed by thj 

The option will cause the standard i 
command to be the standard input to the 


e current directofy. 

iput to the uux 
command-string. 


For example, the command 

uux "Idiff usgl/usr/dan/fl pwbal/a4^dan/f 1 > lfi.dif]^" 


will get the fl files from the usg and p 
execute a diff command and put the resul 
local directory. 

Any special shell characters such as <>; 
either by quoting the entire command-str 
special characters as individual argumen 


wba machines, 
ts in fl.diff in 


PILES 


/usr/uucp/spool - spool directory 
/usr/uucp/* - other data and programs 

SEE ALSO 

uucp(l) 

D. A. Nowitz, Uucp implementation descri ption 


WARNING 

An installation may, and for security re 
will, limit the list of commands execute 
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incoming request from uux. Typically, a restricted site will 
permit little other than the receipt of mail via uux . 

BUGS 

Only the first command of a shell pipeline may have a 
system-name I. All other commands are executed on the system 
of the first command. 

The use of the shell metacharacter * will probably not do 
what you want it to do. 

The shell tokens << and >> are not implemented. 

There is no notification of denial of execution on the 
remote machine. 
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NAME 


val - validate SCCS file 


SYNOPSIS 

val - 

val C-s] [-rSID] C-mname!] C-ytype] files 
DESCRIPTION 

Val determines if the specified file is 
the characteristics specified by the opt 
Arguments to val may appear in any order 
consist of keyletter arguments, which be^ 
named files. 


an SCCS file meeting 
jLonal argiament liipt. 
The arguments 
in with a and 


Val has a special argument, -, \diich cau 
standard input until an end-of-file cond 
Each line read is independently processe 
command line argument list. 

Val generates diagnostic messages on the 
each command line and file processed and 
single 8-bit code upon exit as described 


ses reading of th(i 
ition is detectedt 
ii as if it were 


The keyletter arguraents are defined as f 
of any keyletter argument apply independ^ 
file on the command line. 


pllows. The effects 
ntly to each named 


-s 


-rSID 


The presence of this 
the diagnostic messa 
generated on the sta 
error that is detect 
each named file on a 

The argument value ^ 
IDentification Strin 
number. A check is 
the SID is ambiguous 
ambiguous because it 
exist but implies 1. 
may exist) or invali 
rl.1.0 are invalid b 
can exist as a valid 
the SID is valid and 
check is made to det 
actually exists. 


-mname 


-y type 


The argument value name is compared w^.th 
the SCCS %M% keyword in file. 

The argument value type is compared with 
the SCCS %Y% keyword!in file. 


VAL 1) 


standard output 
also returns a 
below. 


for 


argument silence^ 

E e normally 
dard output for 
d while process! 
given command li 


ID (S^CCS 

is an SCCS delta 
jnade to determine if 
(e. g., rl is 
physically does hot 
L,. 1.2, etc. which 
d (e. g., rl.0 or 
ecause neither cahe 
delta number). If 
not ambiguous, a 
hrmine if it 


any 
ng 
ne. 
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The 8-bit code returned by val is a disjunction of the 
possible errors, i. e., can be interpreted as a bit string 
where (moving from left to right) set bits are interpreted 
as follows: 


bit 0 
bit 1 
bit 2 
bit 3 
bit 4 
bit 5 
bit 6 
bit 7 


= missing file argument; 

= unknown or duplicate keyletter argument; 
= corrupted SCCS file; 

= can't open file or file not SCCS; 

= SID is invalid or ambiguous; 

= SID does not exist; 

= %Y%, -y mismatch; 

= %M%, -m mismatch; 


Note that val can process two or more files on a given 
command line and in turn can process multiple command lines 
(when reading the standard input). In these cases an 
aggregate code is returned - a logical OR of the codes 
generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

DIAGNOSTICS 

Use help d) for explanations. 


BUGS 

V^l can process up to 50 files on a single command line. 
Any number above 50 will produce a core dump. 
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NAME 


VC - version control 


SYNOPSIS 

VC C“a3 C-t] C-cchar3 C-s] Ckeyword=valu4 

DESCRIPTION 

The vc^ command copies lines from the starj' 
standard output under control of its arg 


umi 


statements encountered in the standard ir^put. In the 

user declared 
lvalue when they 


process of performing the copy operation,] 
keywords may be replaced by their string 
appear in plain text and/or control statements. 


The copying of lines from the standard i 
output is conditional, based on tests (ii4 
statements) of keyword values specified 
statements or as vc command arguments. 


rfput to the standa] 
control 
n control 


A control statement is a single line begij 
control character, except as modified by 
(see below). The default control charactj 
except as modified by the -c keyletter (s 
lines beginning with a backslash (\) foil 
character are not control lines and are 
standard output with the backslash remov 
with a backslash followed by a non-contrcf 
copied in their entirety. 


A keyword is composed of 9 or less alphan 
must be alphabetic. A value is any ASCII 
created with ed(l); a numeric value is an 
digits. Keyword values may not contain 

Replacement of keywords by values is done 
surrounded by control characters is encou 
control statement. The -a keyletter (see 
replacement of keywords in all lines of 
uninterpreted control character may be inj 
by preceding it with \. If a literal \ 
too must be preceded by \. 


Keyletter argximents 


-a 


Forces replacement of 
surrounded by control 
their assigned value 
and not just in vc st] 


-t 


th 


All characters from 
line up to and includ 
character are ignored 
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detecting a control statement. If one 
is found, all characters up to and 
including the tab are discarded. 

Specifies a control character to be used 
in place of :. 

Silences warning messages (not error) 
that are normally printed on the 
diagnostic output. 

Version Control Statements 

:dcl keywordC, ••./ keyword!) 

Used to declare keywords. All keywords must be 
declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement 
overrides the assignment for the corresponding keyword 
on the VC command line and all previous asg's for that 
keyword. Keywords declared, but not assigned values 
have null values. 

:if condition 


send 

Used to skip lines of the standard input. If the 
condition is true all lines between the ^ statement 
and the matching end statement are copied to the 
standard output. If the condition is false, all 
intervening lines are discarded, including control 
statements. Note that intervening statements and 
matching end statements are recognized solely for the 
purpose of maintaining the proper if-end matching. 

The syntax of a condition iss 

C "not” ] <or> 

<and> I <and> "|" <or> 

<exp> I <exp> <and> 

”(" <or> ")" I <value> <op> <value> 

** = •* I I 11^*1 I II ^ II 

<arbitrary ASCII string> I <numeric string> 

The available operators and their meanings ares 

= equal 

1= not equal 

& and 

I or 

> greater than 

< less than 

( ) used for logical groupings 


<cond> s: 
<or> s s 
<and> s 
<exp> 

<op> 
<value> 


-c char 

-8 


9 
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not may only occur immediately after the and 
when present, inverts the value of the 
entire condition 

The > and < operate only on unsigned integer values (e. 
g.j 012 > 12 is false). All other operators take 
strings as arguments (e. g.: 012 1=^ 12 is true). The 
precedence of the operators (from highest to lowest) 
is: 

= 1= > < all of equal precedence 

Sc 

I 

Parentheses may be used to alter the order of 
precedence. 

Values must be separated from operators or parentheses 
by at least one blank or tab. 

::text 

Used for keyword replacement on lires that are copied 
to the standard output. The two leading control 
characters are removed, and keywords surrounded by 
control characters in text are replaced by their value 
before the line is copied to the output file. This 
action is independent of the -a kejletter. 

:on 

:off 

Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed ty: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and 
returns an exit code of 1. 

DIAGNOSTICS 

Use help (1) for explanations. 

EXIT CODES 

0 - normal 
1 - any error 
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NAME 

vi - screen oriented (visual) display editor based on ex 
SYNOPSIS 

vi C ~t tag ] C -r ] C -Hineno ] name .. . 


DESCRIPTION 

Vi (visual) is a display oriented text editor based on 
^il)» ^ and vi run the same code; it is possible to get 

to the command mode of ex from within vi and vice-versa. 


The Vi Quick Reference card and the introduction to Display 
Editing with Vi provide full details on using vi. 


FILES 

See ex(l). 


SEE ALSO 

ex(l), vi(l), "vi Quick Reference*' card, "An Introduction 
to Display Editing with Vi* *. 


BUGS 

Scans with / and ? begin on the next line, skipping the 
remainder of the current line. 

Software tabs using ^T work only immediately after the 
autoindent. 


Left and right shifts on intelligent terminals don't make 
use of insert and delete character operations in the 
terminal. 

The wrapmarqin option can be fooled since it looks at output 
columns when blanks are typed. If a long word passes 
through the margin and onto the next line without a break, 
then the line won't be broken. 

Insert/delete within a line can be slow if tabs are present 
on intelligent terminals, since the terminals need help in 
doing this correctly. 

Occasionally inverse video scrolls up into the file from a 
diagnostic on the last line. 

Saving text on deletes in the named buffers is somewhat 
inefficient. 

The source command does not work when executed as :source; 
there is no way to use the :append, :change, and :insert 
commands, since it is not possible to give more than one 
line of input to a ; escape. .To use these on a :global you 
must Q to ejc command mode, execute them, and then reenter 
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NAME 

view - screen oriented (visual) display editor based on ex 

SEE 

vi(l) 
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NAME 

wall - write to all users 

SYNOPSIS 

/etc/wall 


DESCRIPTION 

Wall reads its standard input until an e 
sends this message, preceded by 'Broadcajs 
all logged in users. 


hd-of-file. 
t Message 


The sender should be super-user to overrjlde any protectiojis 
the users may have invoked. 


It th 


en 

to 


FILES 

/dev/tty? 

/etc/utmp 

SEE ALSO 

mesg(l), write(l) 

DIAGNOSTICS 

'Cannot send to ...' 
fails. 


when the open on a user's tty file 
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NAME 

wc - word count 


SYNOPSIS 

WC C -Iwcpt ] C -bbaud ] [ 


-s pagesize ] C -u ] C -v ] [ name 


DESCRIPTION 

Wc counts lines, words and characters, and optionally pages 
and the print time, in the named files, or in the standard 
input if no name appears. A word is a maximal string of 
characters delimited by spaces, tabs or newlines. 


If an argument beginning with one of ''iwcpt* * is present, 
the specified counts (lines, words, characters, pages, or 
time) are selected by the letters 1, w, c, p, or t. The 
default is -Iwc unless -v is specified. 


The -b option asks that the time be figured at the specified 
baud rate instead of the default 300 baud. 


The -s option specifies that pages are pagesize lines long 
instead of the default 66. 


The -u options asks that the time printed be based on uucp 
transmission time, about 90% as fast as normal. 

The -V option asks for a verbose output format, with headers 
and including pages and time by default. 


BUGS 

The times given do not take into account variable factors 
such as system load; delays due to tab expansion or tty 
driver delays, which can be a factor with cu; or uucp delays 
such as mail headers, auxiliary protocol files, or the time 
taken to initially connect to another site. 
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NAME 

what - identify SCCS files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given files for all oc 
pattern that get (1) substitutes for %Z% 
this printing) and prints out what folio] 
", >, new-line, \, or null character, 
program in file f.c contains 

char ident[] = "@(#)identification 

and f.c is compiled to yield f.o and a.o 

what f.c f.o a.out 

will print 


Icurrences of the 
(this is @(#) at 
ijws until the first 
pr example, if the C 


information"? 
ht, then the command 


f.c: 


f.o: 


a.out: 


identification information 


identification information 


identification information 


^Vhat is intended to be used in conjuncti 
get (1), which automatically inserts iden 
but it can also be used where the inform] 
manually. 

SEE ALSO 

get(l), help(l). 

DIAGNOSTICS 

Use help (l) for explanations. 


WHAT 


( 1 ) 


on with the command 
tifying information, 
ation is inserted 


BUGS 


It's possible 
@(#) could be 
in nearly all 


that an unintended occurre 
found just by chance, but 
cases. 


pee of the pattern 
this causes no harm 
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NAME 

who - who is 

SYNOPSIS 

who C who-file 


on the system 
] C am I ] 


DESCRIPTION 

Who# without an argument, lists the login name, terminal 
neime, and login time for each current UNIX user. 

Without an argument, who examines the /etc/utmp file to 
obtain its information. If a file is given, that file is 
examined. Typically the given file will be /usr/adm/wtmp, 
which contains a record of all the logins since it was 
created. Then who lists logins, logouts, and crashes since 
the creation of the wtmp file. Each login is listed with 
user name, terminal name (with '/dev/' suppressed), and date 
and time. When an argument is given, logouts produce a 
similar line without a user name. Reboots produce a line 
with 'x' in the place of the device name, and a fossil time 
indicative of when the system went down. 

With two arguments, as in 'who am I' (and also 'who are 
tells who you are logged in as. 

PILES 

/etc/utmp 
SEE ALSO 

getuid(2), utmp(5) 
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NAME 

whoarai - print effective current user id 

SYNOPSIS 

whoeuni 


DESCRIPTION 

Whoami 

while 


prints who you are. It works everi if you 
who am i' does not since it uses /etc/utmi 


FILES 

/etc/passwd Name data base 

SEE ALSO 

who (1) 

AUTHOR 

Bill Joy 


WHOMAI(I) 


are su'd. 
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NAME 

write - write to another user 
SYNOPSIS 

write user [ ttyname 3 
DESCRIPTION 

Write copies lines from your terminal to that of another 
user. When first called, it sends the message 

Message from yourname yourttyname... 

The recipient of the message should write back at this 
point. Communication continues until an end of file is read 
from the terminal or an interrupt is sent. At that point 
write writes 'EOT' on the other terminal and exits. 

If you want to write to a user who is logged in more than 
once, the ttyname argument may be used to indicate the 
appropriate terminal neime. 

Permission to write may be denied or granted by use of the 
mesg command. At the outset writing is allowed. Certain 
commands, in particular nroff and £r(l) disallow messages in 
order to prevent messy output. 

If the.character is found at the beginning of a line, 
write calls the shell to execute the rest of the line as a 
command. 

The following protocol is suggested for using write ; when 
you first write to another user, wait for him to write back 
before starting to send. Each party should end each message 
with a distinctive signal-(o) for 'over' is conventional- 
that the other may reply. (oo) for 'over and out' is 
suggested when conversation is about to be terminated. 


FILES 

/etc/utmp to find user 
/bin/sh to execute 'I' 

SEE ALSO 

mesg(l), who(l), raail(l) 
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NAME 

wtty - set window modes 
SYNOPSIS 

wtty C C-]mode ] ... C spec C val ]]...[ all ] 
DESCRIPTION 

Wtty sets or displays window modes, size, and position 
parameters. The following modes can be enables. If preceded 
by a minus sign, the the mode is disabled. 

scroll Causes the text in the window to scroll up when at 
bottom of the window. 

wrap Causes the line to wrap around when end of line is 

reached. 

csr Enables the cursor. 

label The label at the top of the window appears. 

save Textual data in an obscured window is saved and 

then restored when the window is no longer 
obscured, 

bflsp Sets big font line spacing. 

Spec parameters allow setting window size! and position. The 
val pareuneter specifies either a coordinate or- dimension In 
pixels. 

uclx X-coordinate of upper left-hanci corner of the 

window. 

ulcy Y-coordinate of upper left-hand corner of the 

window. 

width Specifies the width of the window. 

height Specifies the height of the window. 

all Displays the current modes, positions and size of 

the window. 
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NAME 

xstr - extract strings from C programs to implement shared 
strings 

SYNOPSIS 

xstr C -c ] C - 3 C file ] 

DESCRIPTION 

Xstr maintains a file strings into which strings in 
component parts of a large program are hashed. These 
strings are replaced with references to this common area. 
This serves to implement shared constant strings, most 
useful if they are also read-only. 

The command 

xstr -c name 

will extract the strings from the C source in name, 
replacing string references by expressions of the form 
(&xstrCnumber]) for some number. An appropriate declaration 
of xstr is prepended to the file. The resulting C text is 
placed in the file x*£» to then be compiled. The strings 
from this file are placed in the strings data base if they 
are not there already. Repeated strings and strings which 
are suffices of existing strings do not cause changes to the 
data base. 

After all components of a large program have been compiled a 
file declaring the common xstr space can be created by 

a command of the form 

xstr 

This x£.£ file should then be compiled and loaded with the 
rest of the program. If possible, the array can be made 
read-only (shared) saving space and swap overhead. 


Xstr can also be used on a single file. A command 
xstr name 

creates files jc.c and 2 is.£ as before, without using or 
affecting any strings file in the same directory. 

It may be useful to run xstr after the C preprocessor if any 
macro definitions yield strings or if there is conditional 
code which contains strings which may not, in fact, be 
needed. Xstr reads from its standard input when the 
argument * -' ^is given. An appropriate command sequence for 
running xstr after the C preprocessor is; 
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cc -E name.c I 
cc -c x.c 
rav x.o name.o 


xstr -c - 


Xstr does not touch the file strings uni 
added, thus make can avoid remaking xs«o 
necessary. 


PILES 

strings 

x.c 

xs.c 

/tmp/xs* 

SEE ALSO 

mkstr(l) 

AUTHOR 

Bill Joy 


Data base of strings 
Massaged C source 
C source for definition of arr 
Temp file when 'xstr name' doe 


BUGS 


If a string is a suffix of another strin 
but the shorter string is seen first by 
will be placed in the data base, when ju 
longer one there will do. 


g in the data bas 
xstr both strings 


Bt placing the 
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NAME 

intrO/ errno - introduction to system calls and error 
numbers 

SYNOPSIS 

#include <errno.h> 

DESCRIPTION 

Section 2 of this manual lists all the entries into the 
system. Most of these calls have an error return. An error 
condition is indicated by an otherwise impossible returned 
value. Almost always this is -1; the individual sections 
specify the details. An error number is also made available 
in the external variable errno . Errno is not cleared on 
successful calls, so it should be tested only after an error 
has occurred. 

There is a table of messages associated with each error, and 
a routine for printing the message; See perror (3). The 
possible error numbers are not recited with each writeup in 
section 2, since many errors are possible for most of the 
calls. Here is a list of the error numbers, their names as 
defined in <errno.h>, and the messages available using 
perror . 

0 Error 0 

Unused. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a 
file in some way forbidden except to its owner or 
super-user. It is also returned for attempts by 
ordinary users to do things allowed only to the super- 
user. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the 
file should exist but doesn't, or when one of the 
directories in a path name does not exist. 

3 ESRCH No such process 

The process whose number was given to signal and ptrace 
does not exist, or is already dead. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), 
which the user has elected to catch, occurred during a 
system call. If execution is resumed after processing 
the signal, it will appear as if the interrupted system 
call returned this error condition. 

5 EIO l/O error 
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Isubdevice that do 


ENXIO No such device or address 
l/O on a special file refers to a 
not exist, or beyond the limits of the device. It 
also occur when, for example, a tape drive is not 
dialled in or no disk pack is loaded on a drive. 


E2BIG Arg list too long 

An argument list longer than 5120 bytes is presented 


exec. 


ENOEXEC Exec format error 

A request is made to execute a file which, although it 
has the appropriate permissions, does not start with a 
valid magic number, see a.out(5). I 


EBADF Bad file number 

Either a file descriptor refers to 
read (resp. write) request is made 
open only for writing (resp. 


reading) 


no open file, or la 
to a file that is 


3S 

nay 


to 


10 


11 


12 


ECHILD No children 
Wait and the process has no living 
children. 


or unwaited-for 


13 


14 


15 


em 

ent 


EAGAIN No more processes 

In a fork , the system's process talDle is full or tho 
user is not allowed to create any i^ore processes 

EHOMEM Not enough core 

During an exec or break , a program asks for more 
than the system is able to supply. This is not 
temporary condition; the maximum core size is a syst 
parameter. The error may also occdr if the arrangem 
of text, data, and stack segments requires too many 
segmentation registers. 

EACCES Permission denied 

An attempt was made to access a file in a way forbidden 
by the protection system. 

EFAULT Bad address 

The system encountered a hardware iault in attemptin 
to access the arguments of a system call. ' 


ENOTBLK Block device required 
A plain file was mentioned where a 
required, e.g. in mount ♦ 


block device was 
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16 EBUSY Mount device busy 

An attempt to mount a device that was already mounted 
or an attempt was made to dismount a device on which 
there is an active file (open file, current directory, 
mounted-on file, active text segment). 

17 EEXIST Pile exists 

An existing file was mentioned in an inappropriate 
context, e.g. link . 

18 EXDEV Cross-device link 

A link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system 
call to a device; e.g. read a write-only device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is 
required, for example in a path name or as an argument 
to chdir . 

21 EISDIR Is a directory 

An attempt to write on a directory. 

22 EINVAL Invalid argument 

Some invalid argument: dismounting a non-mounted 
device, mentioning an unknown signal in signal , reading 
or writing a file for which seek has generated a 
negative pointer. Also set by math functions, see 
intro (3). 

23 ENFILE File table overflow 

The system's table of open files is full, and 
temporarily no more opens can be accepted. 

24 EMFILE Too many open files 

Customary configuration limit is 20 per process. 

25 ENOTTY Not a typewriter 

The file mentioned in stty or qtty is not a terminal or 
one of the other devices to which these calls apply. 

26 ETXTBSY Text file busy 

An attempt to execute a pure-procedure program that is 
currently open for writing (or readingl). Also an 
attempt to open for writing a pure-procedure program 
that is being executed. 

27 EFBIG File too large 

The size of a file exceeded the maximum (about 1.0E9 
bytes). 
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ENOSPC No space left on device 
During a write to an ordinary fil^, there is no fr4 
space left on the device. 


ESPIPE Illegal seek 
An IseeTc was issued to a pipe, 
be issued for other non-seekable 


Tl^is error should 4lso 
devices. 


EROFS Read-only file system 
An attempt to modify a file or directory was made c[n a 
device mounted read-only. 

EMLINK Too many links 

An attempt to make more than 32767 links to a file 


32 


33 


34 


EPIPE Broken pipe 
A write on a pipe for which there 
the data. This condition normally 
the error is returned if the signal 


is no process to read 
generates a signjal; 
is ignored. 


EDOM Math argument 
The argument of a function in the 
out of the domain of the function. 

ERANGE Result too large 
The value of a function in the mati' 
unrepresentable within machine pre 


SEE ALSO 

intro{3) 

ASSEMBLER 

as /usr/lnclude/sys.s file 


math package (3M) 


h package (3M) isj 
cision. 


The PDPll assembly language interface i 
system call. The assembler symbols are! 
'/usr/include/sys.s'. 


s given for each 
defined in 


and 


Th 


Return values appear in registers r0 
count on these registers being preserve; 
expected. An erroneous call is always 
on the c-bit of the condition codes, 
returned in r0. The presence of an errj' 
tested by the instructions bes and bee 
(or clear)'). These are synonyms for tf 
instructions. 

On the Interdata 8/32, the system call 
well to the arguments of the C routines 


rl; it is unwise to 
d when no value is 
indicated by turning 
e error number is 
or is most easily 
('branch on error set 
Ihe bes and bcc 


jarguments correspend 
The sequence ib: 


IS 


la %2,errno 
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1 %0,&callno 

SVC 0,args 

Thus register 2 points to a word into which the error number 
will be stored as needed; it is cleared if no error occurs. 
Register 0 contains the system call number; the nomenclature 
is identical to that on the PDPll. The argument of the svc 
is the address of the arguments, laid out in storage as in 
the C calling sequence. The return value is in register 2 
(possibly 3 also, as in pipe ) and is -1 in case of error. 

The overflow bit in the program status word is also set when 
errors occur. 
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NAME 


access - determine accessibility of file 


SYNOPSIS 

access(name, mode) 
char *name; 

DESCRIPTION 

Access checks the given file name for accessibility 
according to mode , which is 4 (read), 2 (write) or 1 
(execute) or a combination thereof. Specifying mode 0 te 
whether the directories leading to the file can be search 
and the file exists. 

An appropriate error indication is returned if ncune cannoj 
be found or if any of the desired access modes would not 
granted. On disallowed accesses -1 is returned and the 
error code is in errno . 0 is returned from successful 
tests. 

I 

The user and group IDs with respect to which permission i 


sts 

led 


t 

be 


checked are the real UID and GID of the 
call is useful to set-UID programs. 


process, so this 


Notice that it is only access bits that are checked. A 
directory may be announced as writable by access , but an 
attempt to open it for writing will fail (although files fnay 
be created there); a file may look execiitable, but exec wfLll 
fail unless it is in proper format. 

SEE ALSO 

stat(2) 

ASSEMBLER 

(access = 33.) 
sys access; name; mode 


( 2 ) 
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NAME 

acct - turn accounting on or off 

SYNOPSIS 

acct(file) 
char *file; 

DESCRIPTION 

The system is prepared to write a record in an accounting 
file for each process as it terminates. This call, with a 
null-terminated string naming an existing file as argument, 
turns on accounting; records for each terminating process 
are appended to file . An argument of 0 causes accounting to 
be turned off. 

The accounting file format is given in acct(5). 

SEE ALSO 

acct(5), sa(l) 

DIAGNOSTICS 

On error -1 is returned. The file must exist and the call 
may be exercised only by the super-user. It is erroneous to 
try to turn on accounting when it is already on. 


BUGS 

No accounting is produced for programs running when a crash 
occurs. In particular nonterminating programs are never 
accounted for. 

ASSEMBLER 

(acct = 51.) 

sys acct; file 
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NAME 

alarm - schedule signal after specified time 

SYNOPSIS 

alarm(seconds) 
unsigned seconds; 

DESCRIPTION 

Alarm causes signal SIGALRM, see signal (2)^ to be sent to 
the invoking process in a number of seconds given by the 
argument. Unless caught or ignored, the signal terminates 
the process. 

Alarm requests are not stacked; successive calls reset the 
alarm clock. If the argument is 0, any alarm request is 
cancelled. Because the clock has a 1-second resolution, the 
signal may occur up to one second early; because of 
scheduling delays, resumption of execution of when the 
signal is caught may be delayed an arbitrary amount. The 
longest specifiable delay time is 65535 seconds. 

The return value is the amount of time previously remaining 
in the alarm clock. 

SEE ALSO 

pause(2), signal(2), sleep(3) 

ASSEMBLER 

(alarm = 27.) 

(seconds in r0) 
sys alarm 

(previous amount in r0) 


I 

I 

j 

i 
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NAME 

brk, sbrk/ break - change core allocation 

SYNOPSIS 

char *brk(addr) 

char *sbrk(incr) 

DESCRIPTION 

Brk sets the system's idea of the lowest location not used 
by the program (called the break) to addr (rounded up to the 
next multiple of 64 bytes on the PDPll, 256 bytes on the 
Interdata 8/32, 512 bytes on the VAX-li/780). Locations not 
less than addr and below the stack pointer are not in the 
address space and will thus cause a memory violation if 
accessed. 


In the alternate function sbrk , incr more bytes are added to 
the program's data space and a pointer to the start of the 
new area is returned. 


^Vhen a program begins execution via exec the break is set at 
the highest location defined by the program and data storage 
areas. Ordinarily, therefore, only programs with growing 
data areas need to use break . 

SEE ALSO 

exec(2), malloc(3), end(3) 


DIAGNOSTICS 

Zero is returned if the break could be set; -1 if the 
program requests more memory than the system limit or if too 
many segmentation registers would be required to implement 
the break. 


BUGS 

Setting the break in the range 0177701 to 0177777 (on the 
PDPll) is the same as setting it to zero. 

ASSEMBLER 

(break =17.) 
sys break; addr 

Break performs the function of brk. The name of the routine 
differs from that in C for historical reasons. 
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NAME 

chdir, chroot - change default directory 

SYNOPSIS 

chdir(dlrname) 
char *dirname; 

chroot(dlrname} 

char *dlrname; I 


DESCRIPTION 

Dirname is the address of the pathneune of a directory, 
terminated by a null byte, ^dir causesj this directory 
become the current working directory, th^ starting point 
path names not beginning with i 


to 


for 


Chroot sets the root directory, the starting point for path 
names beginning with The call is restricted to the 

super-user. I 

i 

SEE ALSO I 

Cd(l) 

DIAGNOSTICS 

Zero is returned if the directory is changed; -1 is returned 
if the given name is not that of a directory or is not 
searchable. | 

I 

ASSEMBLER | 

(chdir =12.) | 

sys chdir; dirname 

(chroot = 61.) 
sys chroot; dlrnsune 
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NAME 

chmod - change mode of file 
SYNOPSIS 

chmod(neune, mode) 
char *neune; 

DESCRIPTION 

The file whose name is given as the null-terminated string 
pointed to by neime has its mode changed to mode . Modes are 
constructed by ORing together some combination of the 
following: 

04000 set user ID on execution 
02000 set group ID on execution 
01000 save text image after execution 
00400 read by owner 
00200 write by owner 

00100 execute (search on directory) by owner 
00070 read, write, execute (search) by group 
00007 read, write, execute (search) by others 

If an executable file is set up for sharing (-n or -i option 
of 1^(1)) then mode 1000 prevents the system from abandoning 
the swap-space image of the program-text portion of the file 
when its last user terminates. Thus when the next user of 
the file executes it, the text need not be read from the 
file system but can simply be swapped in, saving time. 
Ability to set this bit is restricted to the super-user 
since swap space is consumed by the images; it is only worth 
while for heavily used commands. 

Only the owner of a file (or the super-user) may change the 
mode. Only the super-user can set the 1000 mode. 

SEE ALSO 

chmod(1) 

DIAGNOSTIC 

Zero is returned if the mode is changed; -1 is returned if 
name cannot be found or if current user is neither the owner 
of the file nor the super-user. 

ASSEMBLER 

(chmod =15.) 

sys chmod; name; mode 
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NAME 


chown - change owner and group of a fil.e 


SYNOPSIS 

chown(neune, owner, group) 
char *name; 

DESCRIPTION 

The file whose name is given by the null-terminated strijng 
pointed to by name has its owner and group changed as 
specified. Only the super-user may execute this call, 
because if users were able to give fileis away, they coulld 
defeat the (nonexistent) file-space accounting procedures. 

SEE ALSO 

chown(l), passwd(5) 


DIAGNOSTICS 

Zero is returned if the owner is chang^ 
illegal owner changes. 

ASSEMBLER 

(chown = 16.) 

sys chown; name; owner; group 


d; -1 is returned on 
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NAME 

close - close a file 


SYNOPSIS 

close(flldes) 


DESCRIPTION 

Given a file descriptor such as returned from an open / 
great / dup or pipe (2) call, close closes the associated 
file. A close of all files is automatic on exit / but since 
there is a limit on the number of open files per process/ 
close is necessary for progreuns which deal with many files. 

Files are closed upon termination of a process/ and certain 
file descriptors may be closed by exec (2) (see ioctl (2)). 

SEE ALSO 

creat(2)/ open(2)/ pipe(2), exec(2)/ ioctl(2) 

DIAGNOSTICS 

Zero is returned if a file is closed; -1 is returned for an 
unknown file descriptor. 

ASSEMBLER 

(close = 6.) 

(file descriptor in r0) 
sys close 
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NAME 

Great - create a new file 
SYNOPSIS 

creat(name, mode) 
char *name; 

DESCRIPTION 

Great creates a new file or prepares to rewrite an existing 
file called name / given as the address of a null-terminal:ed 
string. If the file did not exist, it is given mode mod(i, 
as modified by the process's mode mask (see umask (2)). iaso 
see chmod (2) for the construction of the mode argument. 

If the file did exist, its mode and owner remain unchanged 
but it is truncated to 0 length. 

The file is also opened for writing, and its file descriptor 
is returned. 

The mode given is arbitrary; it need not allow writing. 

This feature is used by programs which deal with temporary 
files of fixed names. The creation is done with a mode that 
forbids writing. Then if a second instance of the progreim 
attempts a creat , an error is returned and the program knows 
that the name is unusable for the moment. 

SEE ALSO 

write(2), close(2), chmod(2), umask (2) 

DIAGNOSTICS | 

The value -1 is returned if: a needed directory is not 
searchable; the file does not exist and the directory in 
which it is to be created is not writable; the file does 
exist and is unwritable; the file is a directory; there are 
already too many files open. 

ASSEMBLER 

(creat = 8.) 

sys creat; name; mode 

(file descriptor in r0) 
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NAME 

dup, dup2 - duplicate an open file descriptor 

SYNOPSIS 

dup(£ildes) 
int fildes; 

dup2(flldes/ £ildes2) 
int fildes, £lldes2; 

DESCRIPTION 

Given a file descriptor returned from an open , pipe , or 
creat call, dup allocates another file descriptor synonymous 
with the original. The new file descriptor is returned. 

In the second form of the call, fildes is a file descriptor 
referring to an open file, and fildes2 is a non-negative 
integer less than the maximum value allowed for file 
descriptors (approximately 19). Dup2 causes fildes2 to 
refer to the same file as fildes . If fildes2 already 
referred to an open file, it is closed first. 


SEE ALSO 

creat(2), open(2), close(2), pipe(2) 

DIAGNOSTICS 

The value -1 is returned if: the given file descriptor is 
invalid; there are already too many open files. 

ASSEMBLER 

(dup = 41.) 

(file descriptor in r0) 

(new file descriptor in rl) 
sys dup 

(file descriptor in r0) 


The dup2 entry is implemented by adding 0100 to fildes . 
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NAME 


execl/ execv, execle, execve, execlp, execvp, exec, exec^ 
environ - execute a file 


SYNOPSIS 

execKneune, arg0, argl, argn, 0) 

char *n£une, *arg0, *argl, *argn; 

execv(name, argv) 
char *name, *argvC ]; 

execle(neune, arg0, argl, ..., argn, 0, envp) 
char *name, *arg0, *argl, ..., *argn, *envpC ]; 

execve(neune, argv, envp); 
char *name, *argvC ], *envpC ]; 

extern char **environ; 

DESCRIPTION 

Exec in all its forms overlays the call 
named file, then transfers to the entry 
image of the file. There can be no retvirn from a succes 
exec; the calling core image is lost. 


ng process with 
point of the cor^ 


ye 


Files remain open across exec unless explicit arrangement; 
has been made; see ioctl (2). Ignored signals remain ignored 
across these calls, but signals that are caught (see 
signal (2)) are reset to their default values. 

Each user has a real user ID and group j[D and an effect! 
user ID and group ID. The real ID identifies the person 
using the system; the effective ID determines his access 
privileges. Exec changes the effective user and group II]) to 
the owner of the executed file if the file has the 'set- 
user-ID' or 'set-group~ID' modes. The teal user ID is ncj>t 
affected. 

The name argument is a pointer to the name of the file to be 
executed. The pointers arg [0], arg Cl] 1.. address null-- 
terminated strings. Conventionally arg t0] is the name of 
the file. ^ 

From C, two interfaces are available. Execl is useful wHen 
a known file with known arguments is being called; the 
arguments to execl are the character sttings constituting 
the file and the arguments; the first argument is 
conventionally the same as the file nam4 (or its last 
component). A 0 argument must end the argument list 

The execv version is useful when the number of arguments is 
unknown in advance; the arguments to ex^cv are the name Qf 


the 

a 

siful 
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the file to be executed and a vector of strings containing 
the arguments. The last argument string must be followed by 
a 0 pointer. 

When a C program is executed, it is called as follows; 

main(argc, argv, envp) 
int argc; 

char **argv, **envp; 

where argc is the argument count and argv is an array of 
character pointers to the arguments themselves. As 
indicated, argc is conventionally at least one and the first 
member of the array points to a string containing the name 
of the file. 

is directly usable in another execv because arovCarcrcl 
is 0. - —^-^ 


Envp is a pointer to an array of strings that constitute the 
environment of the process. Each string consists of a name, 
an =*', and a null-terminated value. The array of 
pointers is terminated by a null pointer. The shell sh(l) 
passes an environment entry for each global shell variable 
defined when the program is called. See environ(5) for some 
conventionally used names. The C run-time start-off routine 
places a copy of envp in the global cell environ , vdiich is 
used by execv and execl to pass the environment to any 
subprograms executed by the current program. The exec 
routines use lower-level routines as follows to pass an 
environment explicitly: 

execle(file, arg0, argl, . . . , argn, 0, environ); 
execve(file, argv, environ); 

Execlp and execvp are called with the same arguments as 
execl and execv, but duplicate the shell's actions in 
searching for an executable file in a list of directories. 
The directory list is Obtained from the environment. 

FILES 

/bin/sh shell, invoked if command file found by execlp or 
execvp 

SEE ALSO 

fork(2), environ(5) 

DIAGNOSTICS 

'the file cannot be found, if it is not executable, if it 
does not start with a valid magic number (see a. out (5)), if 
'^^ximum memory is exceeded, or if the arguments require too 
much space, a return constitutes the diagnostic; the return 
value is -1. Even for the super-user, at least one of the 
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execute-permission bits must be set for 
executed. 


a file to be 


BUGS 


If execvp is called to execute a file tliat turns out to tea 
shell command file, and if it is impossi.ble to execute the 
shell, the values of argv [0] and argv C-j] will be modified 
before return. ~ 


ASSEMBLER 

(exec = 11.) 

sys exec; name; argv 

(exece = 59.) 

sys exece; neune; argv; envp 


Plain exec is obsoleted by exece , 
reasons. 


but re 


mains 


for histori 


cal 


TVhen the called file starts execution on 
stack pointer points to a word containin 
arguments. Just above this number is a 
the argument strings, followed by a null 
by the pointers to the environment strin 
null pointer. The strings themselves fo 
left at the very top of memory. 


the POP11, the 
g the number of 
list of pointers 
pointer, followe 
gs and then anoth 
Ilow; a 0 word is 


to 

d 

er 


sp-> nargs 
arg0 


argn 

0 

env0 


envm 

0 

arg0: <arg0\0> 

• • • 

env0: <env0\0> 

0 


On the Interdata 8/32, the stack begins 
place (currently 0xD0000) and grows upwa 
the layout of data on the stack is as fo 


at a conventional 
rds. After exec . 
Hows. 


int 
arg0: 


0 

byte 


argp0 


int arg0 


int 


0 
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envp0: 

int env0 

• • • 

int 

0 

%2-> 

space 40 

int 

nargs 

int 

argp0 

int 

envp0 

%3-> 



This arrangement happens to conform well to C calling 
conventions. 
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NAME 

exit - terminate process 

SYNOPSIS 

exit(status) 

Int status; 

_exlt(status) 

Int status; 

DESCRIPTION 

Exit is the normal means of terminatincf a process. Exit 
closes all the process's files and noti.fies the parent 
process if it is executing a wait . Thes low-order 8 bits of 
status are available to the parent process. 

This call can never return. 

The C function exit may cause cleanup actions before the 
final 'sys exit'^'I ^The function exit circumvents all 
cleanup. 

SEE ALSO ! 

wait(2) 

ASSEMBLER 

(exit = 1.) 

(status in r0) 
sys exit 


I 

i 
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NAME 

fork - spawn new process 

SYNOPSIS 

fork( ) 

DESCRIPTION 

Fork is the only way new processes are created. The new 
process's core image is a copy of that of the caller of 
fork. The only distinction is the fact that the value 
returned in the old (parent) process contains the process ID 
of the new (child) process, while the value returned in the 
child is 0. Process ID's range from 1 to 30,000. This 
process ID is used by wart(2). 

Files open before the fork are shared, and have a common 
read-write pointer. In particular, this is the way that 
standard input and output files are passed and also how 
pipes are set up. 

SEE ALSO 

wait(2), exec(2) 

DIAGNOSTICS 

Returns -1 and fails to create a process if: there is 
inadequate swap space, the user is not super-user and has 
too many processes, or the system's process table is full. 
Only the super-user can take the last process-table slot. 

ASSEMBLER 

(fork = 2.) 
sys fork 

(new process return) 

(old process return, new process ID in r0) 

The return locations in the old and new process differ by 
one word. The C-bit is set in the old process if a new 
process could not be created. 
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NAME 

getpid - get process identification 

i 

SYNOPSIS 

getpid( ) 

DESCRIPTION 

Getpid returns the process ID of the current process. Most 
often it is used to generate uniquely-named temporary fi:.es. 

SEE ALSO 

mkterap(3) 

ASSEMBLER 

(getpid =20.) 
ays getpid 
(pid in r0) 
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NAME 

getuid, getgid, geteuid, getegid - get user and group 
identity 

SYNOPSIS 

getuid( ) 

geteuid( ) 

getgid( ) 

getegid( ) 

DESCRIPTION 

Getuid returns the real user ID of the current process, 
geteuid the effective user ID. The real user ID identifies 
the person who is logged in, in contradistinction to the 
effective user ID, which determines his access permission at 
the moment. It is thus useful to programs which operate 
using the 'set user ID* mode, to find out who invoked them. 

Getgid returns the real group ID, getegid the effective 
group ID. 


SEE ALSO 

setuid(2) 

ASSEMBLER 

(getuid =24.) 
sys getuid 

(real user ID in r0, effective user ID in rl) 

(getgid = 47.) 
sys getgid 

(real group ID in r0, effective group ID in rl) 
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NAME 


ioctl, stty, gtty - control device 


SYNOPSIS 

#include <sgtty.h> 

loctKfildes, request, argp) 
struct sgttyb *argp; 

stty(flldes, argp) 
struct sgttyb *argp; 

gtty(fildes, argp) 
struct sgttyb *argp; 

DESCRIPTION 

loctl performs a variety of functions o 
files (devices). The writeups of varioj 
4 discuss how ioctl applies to them. 


n character special 
us devices in section 


For certain status setting and status inquiries about 
terminal devices, the functions stty an^ gtty are equiva|Lent 
to 

loctKfildes, TIOCSETP, argp) 
ioctl(fildes, TIOCGETP, argp) 


respectively; see tty (4). 

The following two calls, however, apply 

loctKfildes, FIOCLEX, NULL); 
ioctl(fildes, FIONCLEX, NULL); 


to any open file 


The first causes the file to be closed Automatically during 
a successful exec operation; the second 
of the first. 


reverses the effect 


SEE ALSO 

stty(l), tty(4), exec(2) 

DIAGNOSTICS 

Zero is returned if the call was successful; -1 if the file 
descriptor does not refer to the kind ojf file for which ft 
was intended. 


BUGS 


Strictly speaking, since ioctl may be extended in differtmt 
ways to devices with different properties, argp should have 
an open-ended declaration like 

union { struct sgttyb ...; ... } 
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The important thing is that the size is fixed by 'struct 
sgttyb'. 

ASSEMBLER 

(ioctl = 54.) 

sys ioctl; fildes; request; argp 

(stty = 31.) 

(file descriptor in r0) 
stty; argp 

(gtty = 32.) 

(file descriptor in r0) 
sys gtty; argp 
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NAME 

kill - send signal to a process 

SYNOPSIS 

kill(pld, sig); 

DESCRIPTION 

Kill sends the signal sig to the process specified by the 
process number in r0. See signal (2) for a list of signa]. 

The sending and receiving processes must have the same 
effective user ID, otherwise this call ;Ls restricted to t 
super-user. ' 

If the process number is 0, the signal xs sent to all otl. 
processes in the sender's process group; see tty (4). 

If the process number is -1, and the user is the super-us 
the signal is broadcast universally except to processes 0 
and 1, the scheduler and initialization processes, see 
init (8). 

Processes may send signals to themselves. 

SEE ALSO 

signal(2), kill(l) 

DIAGNOSTICS 

Zero is returned if the process is killed; -1 is returned 
the process does not have the same effective user ID and 
user is not super-user, or if the procesls does not exist. 

ASSEMBLER 

(kill = 37.) 

(process number in r0) 
sys kill; sig 
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NAME 


link - link to a file 


SYNOPSIS 

llnk(namel, name2) 
char *neunel, *name2; 

DESCRIPTION 

A link to namel is created; the link has the name name2 , 
Either name may be an arbitrary path name. 

SEE ALSO 

ln(l), unlink(2) 


DIAGNOSTICS 

Zero is returned when a link is made; -1 is returned when 
namel cannot be found; when name2 already exists; when the 
directory of name2 cannot be written; when an attempt is 
made to link to a directory by a user other than the super- 
user; when an attempt is made to link to a file on another 
file system; when a file has too many links. 

ASSEMBLER 

(link = 9.) 

sys link; namel; ncime2 
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NAME 

lock - lock a process 

SYNOPSIS 

lock(flag) 


in primary memory 


DESCRIPTION 

If the flag argument is non-zero, the 
call will not be swapped except if it 
If the argument is zero, the process i 
may only be executed by the super-user 


process executing this 
jis required to grow, 
unlocked. Thisicall 


BUGS 


Locke d processes interfere with the compaction of prima:: 
memory and can cause deadlock. This system call is not 
considered a permanent part of the system. 


y 


ASSEMBLER 

(lock = 53.) 
sys lock; flag 
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NAME 

Iseek, tell - move read/write pointer 
SYNOPSIS 

long Iseek(flldes, offset, whence) 
long offset; 

long tell(flldes) 

DESCRIPTION 

The file descriptor refers to a file open for reading or 
writing. The read (resp. write) pointer for the file is set 
as follows; 

If whence is 0, the pointer is set to offset'bytes. 

If whence is 1, the pointer is set to its current 
location plus offset . 

If whence is 2, the pointer is set to the size of the 
file plus offset . 

The returned value is the resulting pointer location. 

The obsolete function tell ( fildes ) is identical to 
lseek ( fildes , 0L , 1^) . 

Seeking far beyond the end of a file, then writing, creates 
a gap or 'hole', which occupies no physical space and reads 
as zeros. 

SEE ALSO 

open(2), creat(2), fseek(3) 

DIAGNOSTICS 

-1 is returned for an undefined file descriptor, seek on a 
pipe, or seek to a position before the beginning of file. 

BUGS 

Lseek is a no-op on character special files. 

ASSEMBLER 

(Iseek = 19.) 

(file descriptor in r0) 

sys Iseek; offsetl; offset2; whence 

Offsetl and offset2 are the high and low words of offset ; r0 
and rl contain the pointer upon return. 
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NAME 


c ! 

mknod - make a directory or a special file 


SYNOPSIS 

ndcnod(name, mode, addr) 
char *name; 

DESCRIPTION 

Mknod creates a new file whose name is 


Manual 


mkn6d(2) 


the null-terminated 


string pointed to by name « The mode of the new file 
(including directory and special file bits) is initialised 
from mode. (The protection part of the mode is modifieq by 


the process's mode mask; see umask (2)) 
pointer of the i-node is initialized from a dd r. 
ordinary files and directories addr is 


_ normally zero. In 

the case of a special file, addr specifies which special 
file. 

Mknod may be invoked only by the super-j-user. 

SEE ALSO 

mkdir(l), mknod(l), filsys(5) 

DIAGNOSTICS 

Zero is returned if the file has been made; -1 if the fi|le 
already exists or if the user is not the super-user. 

ASSEMBLER 

(mknod = 14.) 

ays mknod; name; mode; addr 


The first block 
For 
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NAME 

mount, umount - mount or remove file system 
SYNOPSIS 

mount(special, name, rwflag) 
char *special, *name; 

vtmount (special) 
char *special; 

DESCRIPTION 

Mount announces to the system that a removable file system 
has been mounted on the block-structured special file 
special; from now on, references to file name will refer to 
the root file on the newly mounted file system. Special and 
name are pointers to null-terminated strings containing the 
appropriate path names. 

Name must exist already. Name must be a directory (unless 
the root of the mounted file system is not a directory). 

Its old contents are inaccessible while the file system is 
mounted. 

The rwflag argument determines whether the file system can 
be written on; if it is 0 writing is allowed, if non-zero no 
writing is done. Physically write-protected and magnetic 
tape file systems must be mounted read-only or errors will 
occur when access times are updated, whether or not any 
explicit write is attempted. 

Umount announces to the system that the special file is no 
longer to contain a removable file system. The associated 
file reverts to its ordinary interpretation. 

SEE ALSO 

mount(1) 

DIAGNOSTICS 

Mount returns 0 if the action occurred; -1. if special is 
inaccessible or not an appropriate file; if name does not 
exist; if special is already mounted; if name is in use; or 
if there are already too many file systems mounted. 

Umount returns 0 if the action occurred; -1 if if the 
special file is inaccessible or does not have a mounted file 
system, or if there are active files in the mounted file 
system. 

ASSEMBLER 

(mount = 21.) 

sys mount; special; name; irwflag 
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(umount = 22.) 
sys umount; special 
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NAME 

mpxcall - multiplexor and channel interface 
SYNOPSIS 

mpxcalKargl/ arg2, arg3, cmd) 


DESCRIPTION 

Mpxcall supplies a primitive interface to the kernel used by 
the routines listed below. Each routine that uses mpxcall 
passes an integer cmd as the fourth argument. These are 
defined in / usr / include / mx .h. Mpxcall always returns an 
integer which is to be interpreted in accordance with the 
definition of cmd. 


SEE ALSO 

group(2), join(2), extract(2), connect{2), chan(2), 
attach(2), detach{2) 


DIAGNOSTICS 

The value -1 is returned on error. 
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NAME 

nice - change priority of a process 

SYNOPSIS 

int nice (incr) 
int incr; 

DESCRIPTION 

Nice adds the value of incr to the nice value of the calling 
process. A process's nice value is a positive number for 
which a more positive value results in lower CPU priority. 

A maximum nice value of 39 and a minimum nice value of 0 are 
imposed by the system. Requests for values above or below 
these limits result in the nice value being set to the 
corresponding limit. 

Nice will fail and not change the nice value if incr is 
negative and the effective user ID of the calling process is 
not super-user. [EPERM] 

RETURN VALUE 

Upon successful completion, nice returns the new nice value 
minus 20. Otherwise, a value of -1 is returned and errno is 
set to indicate the error. 

SEE ALSO 

nice(l), exec(2). 
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NAME 

open - open for reading or writing 

SYNOPSIS 

open(naune, mode) 
char *neune; 

DESCRIPTION 

Open opens the file name for reading (if mode is 0 ), writing 
(if mode is 1) or for both reading and writing (if mode is 
2). Name is the address of a string of ASCII characters 
representing a path name, terminated by a null character. 

The file is positioned at the beginning (byte 0). The 
returned file descriptor must be used for subsequent calls 
for other input-output functions on the file. 

SEE ALSO 

creat(2), read(2), write(2), dup(2), close(2) 

DIAGNOSTICS 

The value -1 is returned if the file does not exist, if one 
of the necessary directories does not exist or is 
unreadable, if the file is not readable (resp. writable), or 
if too many files are open. 

ASSEMBLER 

(open = 5.) 

ays open; neune; mode 

(file descriptor in r0) 
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NAME 

pause - stop until signal 


SYNOPSIS 

pause( ) 


DESCRIPTION i 

Pause never returns normally. It is ui^ed to give up 
while waiting for a signal from kill(2) or alarm(2). 


SEE ALSO 

kill(l), kill(2), alarm(2). 


signal(2), 


setjmp(3) 


ASSEMBLER 

(pause = 29.) 
sys pause 


control 
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NAME 

phys - allow a process to access physical addresses 
SYNOPSIS 

phys(segreg, size, physadr) 

DESCRIPTION 

The argument segreg specifies a process virtual (data-space) 
address range of 8K bytes starting at virtual address 
segreg x8K bytes. This address range is mapped into physical 
address physadr x64 bytes. Only the first sizex 64 bytes of 
this mapping is addressable. If size is zero, any previous 
mapping of this virtual address range is nullified. For 
example, the call 

phys{6, 1, 0177775); 

will map virtual addresses 0160000-0160077 into physical 
addresses 017777500-017777577. In particular, virtual 
address 0160060 is the PDP-11 console located at physical 
address 017777560. 

This call may only be executed by the super-user. 

SEE ALSO 

PDP-11 segmentation hardware 
DIAGNOSTICS 

The function value zero is returned if the physical mapping 
is in effect. The value -1 is returned if not super-user, 
if segreg is not in the range 0-7, if size is not in the 
range 0-127, or if the specified segreg is already used for 
other than a previous call to phys . 

BUGS 

This system call is obviously very machine dependent and 
very dangerous. This system call is not considered a 
permanent part of the system. 

ASSEMBLER 

(phys = 52.) 

sys phys; segreg; size; physadr 
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NAME 

pipe - create an interprocess channel 

SYNOPSIS 

pipe(£ildes) 
int £ildesC2]; 

DESCRIPTION 

The pipe system call creates an l/O mechanism called a jdpe. 
The file descriptors returned can be used in read and wiite 
operations. When the pipe is written using the descript.or 
fildes Cl] up to 4096 bytes of data are buffered before t.he 
writing process is suspended. A read using the descript.or 
fildes C0] will pick up the data. Writes with a count of 
4096 bytes or less are atomic; no other process can 
intersperse data. 

It is assumed that after the pipe has been set up, two (or 
more) cooperating processes (created by subsequent fork 
calls) will pass data through the pipe with read and write 
calls. 

The Shell has a syntax to set up a linear array of procgisses 
connected by pipes. 

Read calls on an empty pipe (no buffered data) with onl^ one 
end (all write file descriptors closed) returns an end-of- 
file. 

SEE ALSO 

sh(1), read(2), write{2), fork(2) 

DIAGNOSTICS 

The function value zero is returned if the pipe was created; 
-1 if too many files are already open. A signal is 
generated if a write on a pipe with only one end is 
attempted. 

BUGS 

Should more than 4096 bytes be necessary in any pipe amcng a 
loop of processes, deadlock will occur. 

ASSEMBLER 

(pipe = 42.) 
sys pipe 

(read file descriptor in r0) 

(write file descriptor in rl) 
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NAME 

profil - execution time profile 
SYNOPSIS 

profil(buff, bufslz, offset, scale) 
char *buff 7 

Int bufslz, offset, scale; 


DESCRIPTION 

Buff points to an area of core whose length (in bytes) is 
given by bufsiz . After this call, the user's program 
counter (pc) is excunined each clock tick (60th second); 
offset is subtracted from it, and the result multiplied by 
scale ♦ If the resulting number corresponds to a word inside 
buff , that word is incremented. 

The scale is interpreted as an unsigned, fixed-point 
fraction with binary point at the left: 0177777(8) gives a 
1-1 mapping of pc's to words in buff ; 077777(8) maps each 
pair of instruction words together. 02(8) maps all 
instructions onto the beginning of buff (producing a non¬ 
interrupting core clock). 

Profiling is turned off by giving a scale of 0 or 1. It is 
rendered ineffective by giving a bufsiz of 0. Profiling is 
turned off when an exec is executed, but remains on in child 
and parent both after a fork. Profiling may be turned off . 
if an update in buff would cause a memory fault. 

SEE ALSO 

monitor(3), prof(l) 


ASSEMBLER 

(profil = 44. ) 

sys profil; buff; bufslz; offset; scale 
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NAME 

ptrace - process trace 
SYNOPSIS 

tinclude <signal.h> 

ptrace(request, pld, addr, data) 
int *addr; 

DESCRIPTION 

Ptrace provides a means by which a parent process may 
control the execution of a child process, and exeunine and 
change its core image. Its primary use is for the 
implementation of breakpoint debugging I There are four 
arguments whose interpretation depends on a request 
argument. Generally, pid is the process ID of the traced 
process, which must be a child (no more distant descendant) 
of the tracing process. A process beiAg traced behaves 
normally until it encounters some signal whether interneilly 
generated like 'illegal instruction' oi: externally generated 
like 'interrupt.' See signal (2) for th^ listi Then the 
traced process enters a stopped state and its parent is 
notified via wait (2). When the child is in the stopped 
state, its core image can be exeunined and modified using 
ptrace . If desired, another ptrace request can then cause 
the child either to terminate or to continue, possibly 
ignoring the signal. 

The value of the request argument determines the precises 
action of the call: 

0 This request is the only one used by the child procssss; 
it declares that the process is to be traced by its 
parent. All the other arguments are ignored. Peculiar 
results will ensue if the parent does not expect to 
trace the child. 

1,2 The word in the child process's address space at adcir is 
returned. If I and D space are separated, request ] 
indicates I space, 2 D space. Addr must be even. The 
child must be stopped. The input data is ignored. 

3 The word of the system's per-process data area 

corresponding to addr is returned. Addr must be evetn 
and less than 512. This space coni:ains the registei s 
and other information about the process; its layout 
corresponds to the user structure in the system. 

4,5 The given data is written at the word in the process's 
address space corresponding to addr , which must be even. 
No useful value is returned. If I and D space are 
separated, request 4 indicates I space, 5 D space. 
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Attempts to write in pure procedure fail if another 
process is executing the same file. 

6 The process's system data is written, as it is read with 
request 3. Only a few locations can be written in this 
way: the general registers, the floating point status 
and registers, and certain bits of the processor status 
word. 

7 The data argument is taken as a signal number and the 
child‘s execution continues at location addr as if it 
had incurred that signal. Normally the signal number 
will be either 0 to indicate that the signal that caused 
the stop should be ignored, or that value fetched out of 
the process's image indicating which signal caused the 
stop. If addr is (int *)1 then execution continues from 
where it stopped. 

8 The traced process terminates. 

9 Execution continues as in request 7; however, as soon as 
possible after execution of at least one instruction, 
execution stops again. The signal number from the stop 
is SIGTRAP. (On the PDP-ll the T-bit is used and just 
one instruction is executed; on the Interdata the stop 
does not take place until a store instruction is 
executed.) This is part of the mechanism for 
implementing breakpoints. 

As indicated, these calls (except for request 0) can be used 
only when the subject process has stopped. The wait call is 
used to determine when a process stops; in such a case the 
'termination' status returned by wait has the value 0177 to 
indicate stoppage rather than genuine termination. 

To forestall possible fraud, ptrace inhibits the set-user-id 
facility on subsequent exec (2) calls. If a traced process 
calls exec , it will stop before executing the first 
instruction of the new image showing signal SIGTRAP. 

On the Interdata 8/32, 'word' means a 32-bit word and 'even' 
means 0 mod 4. 

SEE ALSO 

wait(2), signal(2), adb(l) 

DIAGNOSTICS 

The value -1 is returned if request is invalid, pid is not a 
traceable process, addr is out of bounds, or data specifies 
an illegal signal number. 

BUGS 
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On the Interdata 8/32, 'as soon as possible' (request 7) 
means 'as soon as a store instruction has been executed.' 


The request 0 call should be able to s 
are to be treated normally and not cau4 
way, for example, programs with Simula 
(which use 'illegal instruction' signal 
rate) could be efficiently debugged. 

The error indication, -1, is a legitim^ 
errno, see intro(2), can be used to di4 


It should be possible to stop a process 
system call; in this way a completely 
could be provided. 


pecify signals which 
e a stop. In this 
tied floating point, 
s at a very high 


te function value 
ambiguate. 


on occurrence of a 
controlled environment 


ASSEMBLER 

(ptrace = 26.) 

(data in r0) 

sys ptrace; pid; addr; request 
(value in r0) 


! 
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NAME 

read - read from file 
SYNOPSIS 

read(flldes, buffer, nbytes) 
char *buffer 7 

DESCRIPTION 

A file descriptor is a word returned from a successful open , 
creat , dup , or pipe call. Buffer is the location of nbytes 
contiguous bytes into which the input will be placed. It is 
not guaranteed that all nbytes bytes will be read; for 
example if the file refers to a typewriter at most one line 
will be returned. In any event the number of characters 
read is returned. 

If the returned value is 0, then end-of-file has been 
reached. 

SEE ALSO 

open(2), creat(2), dup(2), pipe(2) 

DIAGNOSTICS 

As mentioned, 0 is returned when the end of the file has 
been reached. If the read was otherwise unsuccessful the 
return value is -1. Many conditions can generate an error: 
physical l/O errors, bad buffer address, preposterous 
nbytes , file descriptor not that of an input file. 

ASSEMBLER 

(read = 3.) 

(file descriptor in r0) 
sys read; buffer; nbytes 
(byte count in r0) 
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NAME 

setuid, setgid - set user and group ID 

SYNOPSIS 

setuid(uid} 

setgid(gid) 


DESCRIPTION 

The user ID (group ID) o£ the current 
argument. Both the effective and the 
These calls are only permitted to the 
argument is the real ID. 


process is set to I the 
real ID are set. 
uper-user or if tihe 


SEE ALSO 

getuid(2) 


DIAGNOSTICS 

Zero is returned if the user (group) ID 
returned otherwise. 


is 


set; 


-1 is 


ASSEMBLER 

(setuid = 23.) 
(user ID in r0) 
sys setuid 


(setgid =46.) 
(group ID in r0) 
sys setgid 


/83) 
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NAME 

signal - catch or ignore signals 
SYNOPSIS 

#include <signal.h> 

(♦signal(sig, func))() 

(*func)(); 

DESCRIPTION 

A signal is generated by some abnormal event, initiated 
either by user at a typewriter (quit, interrupt), by a 
program error (bus error, etc.), or by request of another 
program (hill). Normally all signals cause termination of 
the receiving process, but a signal call allows them either 
to be ignored or to cause an interrupt to a specified 
location. Here is the list of signals with names as in the 


include 

file 

• 

SIGHUP 

1 

hangup 

SIGINT 

2 

interrupt 

SIGQUIT 

3* 

quit 

SIGILL 

4* 

illegal instruction (not reset when caught) 

SIGTRAP 

5* 

trace trap (not reset when caught) 

SIGIOT 

6* 

lOT instruction 

SIGEMT 

7* 

EMT instruction 

SIGFPE 

8* 

floating point exception 

SIGKILL 

9 

kill (cannot be caught or ignored) 

SIGBUS 

10* 

bus error 

SIGSEGV 

11* 

segmentation violation 

SIGSYS 

12* 

bad argument to system call 

3IGPIPE 

13 

write on a pipe or link with no one to read it 

SIGALRM 

14 

alarm clock 

SIGTERM 

15 

software termination signal 


16 

unassigned 


The starred signals in the list above cause a core image if 
not caught or ignored. 

If func is SIG DFL, the default action for signal sig is 
reinstated; this default is termination, sometimes with a 
core image. If func is SIG_IGN the signal is ignored. 
Otherwise when the signal occurs func will be called with 
the signal number as argument. A return from the function 
will continue the process at the point it was interrupted. 
Except as indicated, a signal is reset to SIG_DFL after 
being caught. Thus if it is desired to catch every such 
signal, the catching routine must issue another signal call. 

When a caught signal occurs during certain system calls, the 
call terminates prematurely. In particular this can occur 
during a read or write (2) on a slow device (like a 
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typewriter; but not a file); and during pause or wait(2). 
When such a signal occurs, the saved user status is arranged 
in such a way that when return from the signal-catching 
takes place, it will appear that the system call returned an 
error status. The user's progreim may then, if it wishes, 
re-execute the call. 

The value of signal is the previous (cr initial) value of 
func for the particular signal. 

After a fork (2) the child inherits all signals. Exec (2) 
resets all caught signals to default action. 

SEE ALSO 

kill(l), kill(2), ptrace(2), setjmpO) 

DIAGNOSTICS 

The value (int)-l is returned if the given signal is out of 
range. 

BUGS 

If a repeated signal arrives before the last one can be 
reset, there is no chance to catch it. 

« 

The type specification of the routine and its func argument 
are problematical. 

ASSEMBLER 

(signal =48.) 

sys signal; sig; label 

(old label in r0) 

If label is 0, default action is reinstated. If label is 
odd, the signal is ignored. Any other even label specifies 
an address in the process where an interrupt is simulated. 

An RTI or RTT instruction will return from the interrupt. 
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i.'JAME 

stat, fstat - get file status 
SYNOPSIS 

#include <sys/types.h> 

#include <sys/stat.h> 

stat(name, buf) 
char *name; 
struct stat *buf; 

fstat(fildes, buf) 
struct stat *buf; 

DESCRIPTION 

Stat obtains detailed information about a named file. Fstat 
obtains the same information about an open file known by the 
file descriptor from a successful open , creat , dup or 
pipe (2) call. 

Name points to a null-terminated string naming a file; buf 
is the address of a buffer into which information is placed 
concerning the file. It is unnecessary to have any 
permissions at all with respect to the file, but all 
directories leading to the file must be searchable. The 
layout of the structure pointed to by buf as defined in 
< stat .h> is given below. St mode is encoded according to 
the *#define' statements. 

/* 

(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1983. ALL 
RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORPORATED. 
RESTRICTED RIGHTS - USE, DUPLICATION, OR DISCLOSURE IS SUBJECT 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE AGREEMENT AND 
ASSOCIATED DOCUMENTATION. 

*/ 

#ifdef SCCSID 

static char id_statC] = "@(#)stat.h 1.-2 (Texas Instruments) 83/06/ 

#endif 

#ifndef SCCSID 

struct stat 

{ 

dev_t st_dev; 

i no_t s t_i no; 

unsigned short st_mode; 

short st_nlink; 

short st_uid; 

short st_gid; 

dev t st rdev; 
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}; 


of f_t 
time_t 
time_t 
time t 


st_size; 
st_atime; 
st_mtime7 
St ctime; 


#define 

#define 

#define 

#define 

tdefine 

#define 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tdefine 

tendif 


S IFMT 


0170000 


S_IFDIR 
S_IFCHR 
S_IFBLK 
S_IFREG 
S_IFMPC 
S IFMPB 


0040000 

0020000 

0060000 

0100000 

0030000 

0070000 


STAT 


( 2 ) 


S_ISUID 

S_ISGID 

S_ISVTX 

S_IREAD 

S_IWRITE 

S lEXEC 


0004000 

0002000 

0001000 

0000400 

0000200 

0000100 


/* ty^ie of file */ 

/* directory */ 

/* character special 
/* block special */ 

/* regular */ 

/* multiplexed char sp 
/* multiplexed block s 
/* se-j: user id on exec 
se^ group id on exe 
saye swapped text ey 
/* read permission, own 
/* wr|te permission, owner */ 
/* execute/search permission. 


/* 

/* 


The mode bits 0000070 and 0000007 encode 
permissions (see chmod(2)). The defined 


group and others 
types, ino t . 


off t , time t , name various width integer values; dev t 
encodes major and minor device numbers; iheir exact 
definitions are in the include file <sys/types.h> (see 
types (5). 

vVhen fildes is associated with a pipe, fstat reports an 


ordinary file with restricted permission^* 
number of bytes queued in the pipe. 


St atime is the file was last read. For 


ycial *j( 
]>ecial 
ution */ 
cution */ 
en after use 
er */ 

/ 

owner 


The size is the 


reasons of 


efficiency, it is not set when a directory is searched, 

although this would be more logical, st _ 

the file was last written or created. It is not set by 
changes of owner, group, link count, or mode. st ctime is| 
set both both by writing and changing th4 i-node. 

SEE ALSO 

ls(l), filsys(5) 

DIAGNOSTICS 

Zero is returned if a status is available 
cannot be found. 

ASSEMBLER 

(stat = 18.) 
sys stat; ncime; buf 

(fstat = 28.) 


; -1 if the file 
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(file descriptor in r0) 
sys fstat; buf 
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NAME 

stirae - set time 


SYNOPSIS 

stime(tp) 
long *tp; 


DESCRIPTION 

Stime sets the system's idea of the ti 
pointed to by is measured in secon 
1, 1970. Only the super-user may use 


me and date. Tim^ 
as from 0000 GMT 
this call. 


JJan 


SEE ALSO 

dated), time(2), Gtime(3) 


DIAGNOSTICS 

Zero is returned if the time was set; 
super-user. 


rl 


if user is not 


the 


ASSEMBLER 

(stime = 25. ) 
(time in r0-rl) 
ays stime 
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NAME 

sync - update super-block 

SYNOPSIS 

sync( ) 


DESCRIPTION 

Sync causes all information in core memory that should be on 
disk to be written out. This includes modified super 
blocks, modified i-nodes, and delayed block l/O. 

It should be used by programs v/hich examine a file system, 
for example icheck , df , etc. It is mandatory before a boot. 


SEE ALSO 

sync(l), update(8) 


BUGS 

The writing, although scheduled, is not necessarily complete 
upon return from sync . 

ASSEMBLER 

(sync = 36.) 
sys sync 
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NAME 


time, ftime - get date and time 


SYNOPSIS 

long time{0) 

long time(tloc) 
long *tloc; 

finclude <sys/types.h> 

#include <sys/timeb.h> 
ftime(tp) 
struct timeb *tp; 

DESCRIPTION 

Time returns the time since 00 : 00:00 GMT, J^an. 1, 1970, 
measured in seconds. 

If tloc is nonnull, the return value is also stored in the 
place to 'svhich tloc points • 

The ftime entry fills in a structure pointed to by its 
argument, as defined by < sys / timeb «h>; 


TIME(2) 




(C) COPYRIGHT, TEXAS INSTRUMENTS INCOifPORATED, 1983. i^LL 
RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORPCRATED. 


OR DISCLOSURE IS 


SUBJECT 


7 


RESTRICTED RIGHTS - USE, DUPLICATION, - 

TO RESTRICTIONS SET FORTH IN TI ' S PROGRAM LICENSE AGREljMENT AtjD 
ASSOCIATED DOCUMENTATION. 


#ifdef SGCSID I , 

static char id_timebC] = "@(#)timeb.hi.2 (Texas Instruments^ 
#endif 

#ifndef SCCSID 
/* 

* Structure returned by ftime system call 
*/ 

struct timeb { 

time_t time; 
unsigned short millitra; 
short timezone; 

short dstflag; 

}; 

#endif 

The structure contains the time since the epoch in seconds, 
up to 1000 milliseconds of more-precise interval, the local 


83/06/27" 
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timezone (measured in minutes of time westward from 
Greenwich), and a flag that, if nonzero, indicates that 
Daylight Saving time applies locally during the appropriate 
part of the year. 

SEE ALSO 

dated), stime(2), ctime(3) 

ASSEMBLER 

(ftime =35.) 
sys ftime; bufptr 

(time = 13.; obsolete call) 
sys time 

(time since 1970 in r0-rl) 
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NAME 

times - get process times 

SYNOPSIS 

times(buffer) 

struct tbuffer *buffer? 


DESCRIPTION 

Times returns time-accounting information 
process and for the terminated child procj 
current process. All times are in l/HZ 
in Worth America. 


After the call, the buffer will appear as follows: 

struct tbuffer { 

long proc_user_time; 
long proc_system_time; 
long child_user_time; 
long child system time; 

}; “ " 

The children times are the sum of the chijldren's process 
times and their children's times. 


for the current 
esses of the 
Seconds, where HZ^60 


SEE ALSO 

time(l), time(2) 

ASSEMBLER 

(times = 43.) 
sys times; buffer 


3) 
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N7VME 

umasTc - set file creation mode mask 

SYNOPSIS 

umask(complmode) 

DESCRIPTION 

Umask sets a mask used whenever a file is created by 
creat (2) or mknod (2); the actual mode (see chmod (2)) of the 
newly-created file is the logical and of the given mode and 
the complement of the argument. Only the low-order 9 bits 
of the mask (the protection bits) participate. In other 
words, the mask shows the bits to be turned off when files 
are created. 

The previous value of the mask is returned by the call. The 
value is initially 0 (no restrictions). The mask is 
inherited by child processes. 

SEE ALSO 

creat(2), raknod(2), chmod(2) 

ASSEMBLER 

(umask = 60.) 

sys umask; complmode 
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NAME 

unlink - remove directory entry 

SYNOPSIS 

unlink(name) 
char *name; 


DESCRIPTION 

Name points to a null-terminated string, 
entry for the file pointed to by name froiii 
If this entry was the last link to the fii 
the file are freed and the file is destro 
the file was open in any process, the act 
delayed until it is closed, even though 
has disappeared. 

SEE ALSO 

rra(l), link(2) 


th 


Unlink removes tne 




its directory, 
e, the contents bf 
ed. If, however, 
al destruction is 
e directory entr^ 


DIAGNOSTICS 

Zero is normally returned; -1 indicates that the file does 
not exist, that its directory cannot be wijitten, or that th| 
file contains pure procedure text that is 
Write permission is not required on the fi, 
also illegal to unlink a directory (exceptf for the super- 
user) . 


currently in use. 
le itself. It isl 


ASSEMBLER 

(unlink = 10.) 
sys unlink; name 
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NAME 

utime - set file times 

SYNOPSIS 

#include <ays/types .h> 
utime{file, timep) 
char *file; 
time_t timepC2]; 

DESCRIPTION 

The atime call uses the 'accessed* and 'updated* times in 
that order from the timep vector to set the corresponding 
recorded times for file . 

The caller must be the owner of the file or the super-user. 
The 'inode-changed* time of the file is set to the current 
time. 


SEE ALSO 

stat (2) 

ASSEMBLER 

(utime =30.) 

sys utime) file; timep 
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NAME 

wait - wait for process to terminate 

SYNOPSIS 

wait(status) 
int *status; 

wait(0) 

DESCRIPTION 

Wait causes its caller to delay until a s 
or one of its child processes terminates, 
died since the last wait # return is imme'd 
no children, return is immediate with the 
(resp. with a value of -1 returned). The 
yields the process ID of the terminated c 
of several children several wait calls ar 
of all the deaths. 


WAIT(2) 


[ignal is received 
If any child ha Is 
late; if there arp 
error bit set 
normal return 
hild. In the cas^ 
e needed to learn 


If (int) status is nonzero, the high byte of the word pointed 
to receives the low byte of the argument of exit when the 
child terminated. The low byte receives the termination 
status of the process. See signal (2) for 
termination statuses (signals); 0 status 
termination. A special status (0177) is 
stopped process v/hich has not terminated 
restarted. See ptrace (2). If the 0200 b 
termination status is set, a core image o 
produced by the system. 


a list of 
indicates normal 
returned for a 
and can be 
it of the 
f the process was 


waiting on its 
cess ID = 1) 


If the parent process terminates without 
children, the initialization process (pro 
inherits the children. 

SEE ALSO 

exit(2), fork(2), signal(2) 

DIAGNOSTICS 

Returns ~1 if there are no children not f^reviously waited 
for. 

ASSEMBLER 

(wait = 7.) 
sys wait 

(process ID in r0) 

(status in rl) 

The high byte of the status is the low bijte of rO in the 
child at termination. 
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NAME 

write - write on a file 
SYNOPSIS 

write{fildes, buffer, nbytes) 
char *buffer; 

DESCRIPTION 

A file descriptor is a word returned from a successful open , 
Great , dup , or pipe (2) call. 

Buf fer is the address of nbytes contiguous bytes which are 
written on the output file. The number of characters 
actually written is returned. It should be regarded as an 
error if this is not the same as requested. 

Writes which are multiples of 512 characters long and begin 
on a 512-byte boundary in the file are more efficient than 
any others. 

SEE ALSO 

creat(2), open(2), pipe(2) 

DIAGNOSTICS 

Returns -1 on error: bad descriptor, buffer address, or 
count; physical l/O errors. 

ASSEMBLER 

(write = 4.) 

(file descriptor in r0) 
sys write; buffer; nbytes 
(byte count in r0) 
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NAME 

intro - introduction to library functions 
SYNOPSIS 

#include <stdio.h> 
finclude <math.h> 

DESCRIPTION 

This section describes functions that may be found in 
various libraries, other than those functions that directly 
invoke UNIX system primitives, which are described in 
section 2. Functions are divided into various libraries 
distinguished by the section number at the top of the page; 

(3) These functions, together with those of section 2 and 
those marked (3S), constitute library libc , which is 
automatically loaded by the C compiler cc(l) and the 
Fortran compiler f77 (1). The link editor Id(1) 
searches this library under the '-Ic' option. 
Declarations for some of these functions may be 
obtained from include files indicated on the 
appropriate pages. 

(3M) These functions constitute the math library, libm . 

They are automatically loaded as needed by the Fortran 
compiler f77 (1). The link editor searches this 
library under the '-Im' option. Declarations for 
these functions may be obtained from the include file 
<math.h>. 

(3S) These functions constitute the 'standard l/O package', 
see stdio (3). These functions are in the library libc 
already mentioned. Declarations for these functions 
may be obtained from the include file <stdio.h>. 

(3X) Various specialized libraries have not been given 
distinctive captions. The files in which these 
libraries are found are named on the appropriate 
pages. 

FILES 

/lib/libc.a 

/lib/libm.a, /usr/lib/libra.a (one or the other) 

SEE ALSO 

stdio(3), nm(l), ld(l), cc(l), f77(l), intro(2) 

DIAGNOSTICS 

Functions in the math library (3M) may return conventional 
values when the function is undefined for the given 
arguments or when the value is not representable. In these 
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cases the external variable errno (see 
the value EDOM or ERANGE. The values of 
defined in the include file <math.h>. 


tro (2)) is set to 
iEDOM and ERANGE a|re 
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NAME 

abort - generate fault 


DESCRIPTION 

Abort executes a trap instruction. This causes a signal 
that normally terminates the process with a core dump, which 
may be used for debugging. 


SEE ALSO 

adb(l), signal(2), exit(2) 

DIAGNOSTICS 

Usually 'trap - core dumped' from the shell. 
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NAME 


abs - integer absolute value 


SYNOPSIS 

abs(i) 

DESCRIPTION 

Abs returns the absolute value of its inte 
SEE ALSO 

floor(3) for fabs 


BUGS 


You get what the hardware gives on the largest negative 
integer. 


ger operand. 
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NAME 

assert - program verification 
SYNOPSIS 

#include <assert.h> 
assert (expression) 

DESCRIPTION 

Assert is a macro that indicates expression is expected to 
be true at this point in the program. It causes an exit (2) 
with a diagnostic comment on the standard output when 
expression is false (0). Compiling with the cg{1) option 
-DNDEBUG effectively deletes assert from the program. 

DIAGNOSTICS 

'Assertion failed: file f line n.' F is the source file and 
n the source line number of the assert statement. 
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NAME 


atof, atoi/ atol - convert ASCII to numbers 


SYNOPSIS 

double atof{nptr) 
char *nptr; 

atoi(nptr) 
char *nptr; 

long atol(nptr) 
char *nptr; 

DESCRIPTION 

These functions convert a string pointe 
floating, integer, and long integer repjresentatlbn 
respectively. The first unrecognized character ends the 
string. 


ATOP(3) 


a to by nptr to 


Atof recognizes an optional string of tabs and spaces, then 
an optional sign, then a string of digits optionally^ 
containing a decimal point, then an optional 'e* or 'E' 
followed by an optionally signed integer. 


Atoi and atol recognize an optional str 


ing of tabs and 


spaces, then an optional sign, then a string of digits. 


SEE ALSO 

scanf{3) 


BUGS 

There are no provisions for overflow. 
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NAME 

crypt, setTcey, encrypt - DES encryption 
SYNOPSIS 

char *crypt(key, salt) 
char *lcey, *salt; 

8etkey(key) 
char *key; 

encrypt(block, edflag) 
char *block; 

DESCRIPTION 

Crypt is the password encryption routine. It is based on 
the NBS Data Encryption Standard, with variations intended 
(among other things) to frustrate use of hardware 
implementations of the DES for key search. 

The first argument to crypt is a user's typed password. The 
second is a 2-character string chosen from the set [a-zA- 
Z0-9./]. The salt string is used to perturb the DES 
algorithm in one of 4096 different ways, after which the 
password is used as the key to encrypt repeatedly a constant 
string. The returned value points to the encrypted 
password, in the same alphabet as the salt. The first two 
characters are the salt itself. 

The other entries provide (rather primitive) access to the 
actual DES algorithm. The argument of setkey is a character 
array of length 84 containing only the characters with 
numerical value 0 and 1. If this string is divided into 
groups of 8, the low-order bit in each group is ignored, 
leading to a 56-bit key which is set into the machine. 

The argument to the encrypt entry is likewise a character 
array of length 64 containing 0's and I's. The argument 
array is modified in place to a similar array representing 
the bits of the argument after having been subjected to the 
DES algorithm using the key set by setkey . If edflag is 0, 
the argument is encrypted; if non-zero, it is decrypted. 

SEE ALSO 

passwd(l), passv/d(5), login(l), getpass(3) 


BUGS 

The return value points to static data whose content is 
overwritten by each call. 
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(3) 


NAME 

ctime, localtime, gmtime, 
and time to ASCII 


asctime. 


timezone - 


SYNOPSIS 

char *ctime(clock) 
long *clock; 

#include| <time.h> 

struct tm *localtime(clock) 
long *clock; 

! 

struct tm *gmtime(clock) 
long *clock; 

char *a8ctime(tm) 
struct tm *tm; 


convert da 


te 


char *timezone( 2 one, dst) 

DESCRIPTION 

Ctiitte converts a time pointed to toy clock such as returnejd 


by time (2) into ASCII and returns a poir^ter to a 26- 
charactejr string in the following form, 
constant width. 


All the fields have 


Sun Sep 16 01;03;52 1973\n\0 

Localtime and gmtime return pointers to 
containing the broken-down time. Local- 


time zone and possible daylight savings 
converts directly to GMT, which is the 
Asctime converts a broken-down time to 
pointer to a 26-character string. 


time; gmtime 
iime UNIX uses. 
SCI! and returns 


structures 

ime corrects for 


the 


The structure 


declaration from the include file is; 


struct tm 

{ /* see ctime(3) 

int 

tra sec; 

int 

tm_min; 

int 

tm_hour; 

int 

tm_mday; 

int 

tm mon; 

int 

tm_year; 

int 

tm_wday; 

int 

tm_yday; 

int 

tm_isdst; 




These quantities give the time on a 24-hour clock, day of 
month (1-31), month of year (0-11), day of week (Sunday = 
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0), year - 1900, day of year (0-365), and a flag that is 
nonzero if daylight saving time is in effect. 

When local time is called for, the program consults the 
system to determine the time zone and whether the standard 
U.S.A. daylight saving time adjustment is appropriate. The 
program knows about the peculiarities of this conversion in 
1974 and 1975; if necessary, a table for these years can be 
extended. 

Timezone returns the name of the time zone associated with 
its first argument, which is measured in minutes westward 
from Greenwich. If the second argument is 0, the standard 
name is used, otherwise the Daylight Saving version. If the 
required name does not appear in a table built into the 
routine, the difference from GMT is produced; e.g. in 
Afghanistan timezone (-(60*4+30), 0) is appropriate because 
it is 4:30 ahead of GMT and the string GMT+4:30 is produced. 

SEE ALSO 

time(2) 


BUGS 

The return values point to static data whose content is 
overwritten by each call. 
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isalphai isupper, islower, isdigit, isa 
ispunctj isprint, iscntrl, isascii - chi 
Glassification 

I 

SYNOPSIS j 

♦include <ctype.h> 

isalpha(c) 


DESCRIPTION 1 

These macros classify ASCI I-coded integj 
lookup.I Each is a predicate returning 
zero foir false. Isascii is defined on 
the resf. are defined only where isascii 
single hon-ASCII value EOF (see stdio (3 


Inum, isspace, 
kracter 


er values by tabl 
nonzero for true, 
all integer value 
is true and on t 
)). 


isalpha 

isupper 

islower 

isdigit 

isalnum 


isspacei 


c is a letter 

c is an upper case lette 

c is a lower case letter 

c is a digit 

c is an alphanumeric cha 

c is a space, tab, carri 
or formfeed 


ispunct 

isprint! 

iscntrl 

isascii! 

SEE ALSO ! 

ascii(7) 


c is a punctuation character (neither coqtrol 
nor alphanumeric) 


c is a printing charactei 
Tspace) through 0176 (td 

c is a delete character 
control character (less 

c is an ASCII character,! 
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fs; 

he 


racter 
age return, newlij 


r, code 040(8) 
Ide) 

(0177) or ordinarl 
than 040). 

code less than 0 
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NAME 

curses - screen functions with ''optimal*' cursor motion 
SYNOPSIS 

cc C flags ] files -Icurses - Itermlib C libraries ] 
DESCRIPTION 

These routines give the user a method of updating screens 
with reasonable optimization. They keep an image of the 
current screen, and the user sets up an image of a new one. 
Then the refresh () tells the routines to make the current 
screen look like the new one. In order to initialize the 
routines, the routine initscr () must be called before any of 
the other routines that deal with windows and screens are 
used. 


SEE ALSO 

Screen Updating and Cursor Movement Optimization : A Library 
Package , Ken Arnold, 

terracap (5), stty (2), setenv (3), setenv (3), 

AUTHOR 

Ken Arnold 


FUNCTIONS 

addch(ch) 
addstr(str) 
box(win,vert,hor) 
crraode() 
clear() 

clearok(scr,boolf) 
clrtobot() 
clrtoeol() 
delwin{win) 
echo() 
erase{) 
getGh() 
getstr(str) 
gettmode() 
getyx(win,y,x) 
inch() 
initscr() 

leaveok(win,boolf) 
longname(terrabuf,name) 
move(y,x) 
ravcur(lasty,lastx,newy,newx) 


add a character to stdscr 
add a string to stdscr 
draw a box around a window 
set cbreak mode 
clear stdscr 

for 


set clear flag 
clear to bottom on 


scr 

stdscr 


clear to end of line on stdscr 
delete win 
set echo mode 
erase stdscr 

get a char through stdscr 
get a string through stdscr 
get tty modes 
get (y,x) co-ordinates 
get char at current (y,x) 
initialize screens 
set leave flag for win 
get long name from termbuf 
move to (y,x) on stdscr 


co-ordinate s 


actually move cursor 
newwin(lines,cols,begin__y,begin_x) create a new window 


nlO 
nocrmode() 
noecho() 
nonl() 
noraw() 


set newline mapping 
unset cbreak mode 
unset echo mode 
unset newline mapping 
unset raw mode 
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overlay(winl,win2) 

overwrite(winl/win2) 

printw(fmt,argl,arg2, ...) 

raw() 

refresh() 

restty() 

save tty() j 

scanw(fmt,argl,arg2,...) 

scroll(win) 

scrollok(win,boolf) 

setterm(name) 

unGtrl(ch) 

waddch(win,ch) 

waddstr (wijn, str) 

wclear (wiri) 

wGlrtobot(iwin) 

WGlrtoeol(win) 
werase(win) 
wgetc'h(win) 
wgetstr(win,str) 
winGh(win); 
wmove(win,jy, x) 

wprintw(win,fmt,argl,arg2,. 
wrefresh(win) 

wsGanw(win, fmt,argl,arg2, .. 


CURSES(3) 


overlay win^ on win2 
overwrite w|nl on top of win$ 
printf on stdsor 
set raw mode 

make ourren^ screen look lik4 
reset tty flags to stored value 
stored current tty flags 
scanf through stdscr 
scroll win <pne line 
set scroll flag 
set term variables for name 
printable version of ^ 
add char to| win 
add string to win 
clear win 

clear to bottom of win 
clear to end of line on win 
erase win 

get a char through win 
get a string through win 


get char at 
set current 
, .) printf on ^in 

make screen]look like win 
.) scanf through win 


current (y,x) in win 
(y,x) co-ordinates on win 


stdscr 
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NAME 

ecvt, fcvt, gcvt - output conversion 
SYNOPSIS 

char *ecvt(value# ndigit# decpt# sign) 
double value; 

int ndigit# *decpt, *sign; 

char *fcvt(value, ndigit# decpt# sign) 
double value; 

int ndlglt# *decpt# *sign; 

char *gcvt(value# ndigit# buf) 
double value; 
char *buf; 

DESCRIPTION 

Ecvt converts the value to a null-terminated string of 
ndigit ASCII digits and returns a pointer thereto. The 
position of the decimal point relative to the beginning of 
the string is stored indirectly through decpt (negative 
means to the left of the returned digits). If the sign of 
the result is negative# the word pointed to by sign is non¬ 
zero, otherwise it is zero. The low-order digit is rounded. 

Fcvt is identical to ecvt, except that the correct digit has 
been rounded for Fortran F-forraat output of the number of 
digits specified by ndigits . 

Gcvt converts the value to a null-terminated ASCII string in 
buf and returns a pointer to buf . It attempts to produce 
ndigit significant digits in Fortran F format if possible, 
otherwise E format, ready for printing. Trailing zeros may 
be suppressed. 

SEE ALSO 

printf(3) 


BUGS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 


end, etext, edata - last locations in pr 


SYNOPSIS 

extern ehd; 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer neither to routines nor to locations wi| 
interesting contents. The address of etext is the first 
address above the program text, edata above the initializl 


END(3) 


log ram 


data region, and end above the uninitial 

;yhen execution begins, the program break 
but many functions reset the progreum bre 
routines; of brk (2), malloc (3), standard 
(stdioO!)), the profile (-p) option of g 
current Value of the program break is r^ 
'sbrk(0)', see brk(2). 

SEE ALSO ! 

brk(2), malloc(3) 


ized data region 

coincides with ^ 
ak, among them th| 
input/output 
£(1), etc. The 
liably returned bt 


|th 

ed 

nd. 
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NAME 

exp, log, logl0, pow, sqrt - exponential, logarithm, power, 
square root 


SYNOPSIS 

♦include <math.h> 


double exp(x) 
double x; 

double log(x) 
double x; 


double logl0(x) 
double x; 

double pow(x, y) 
double X, y; 

double sqrt(x) 
double x; 


DESCRIPTION 

Exp returns the exponential function of x. 


Log returns the natural logarithm of x; logl0 returns the 
base 10 logarithm. 


Pow returns 3c8y9. 

Sqrt returns the square root of 
SEE ALSO 

hypot(3), sinh(3), intro(2) 


DIAGNOSTICS 

Exp and pow return a huge value when the correct value would 
overflow; errno is set to ERANGE. Pow returns 0 and sets 
errno to EDOM when the second argument is negative and non¬ 
integral and v/hen both arguments are 0. 

Log returns 0 when x is zero or negative; errno is set to 
EDOM. 


Sqrt returns 0 when x is negative; errno is set to EDOM. 
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NAME 

fclose, fflush - close or flush a stream 
SYNOPSIS 

#include <stclio.h> 

fclose(stream) 

PILE *streeun; 

fflush(stream) 

FILE *stream; 

DESCRIPTION j 

Fclose causes any buffers for the named s tream to be 
emptied, and the file to be closed. Buffers allocated by 
the standard input/output system are freed. 

Fclose is! performed automatically upon cabling exit (2). 

Fflush causes any buffered data for the reamed output strea m 
to be v/ritten to that file. The stream remains open. 

SEE ALSO 

close(2), fopen(3), setbuf(3) 

DIAGNOSTICS 

These routines return EOF if stream is not associated with 
an output file, or if buffered data cannot be transferred to 
that file. 
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NAME 

feof, ferror, clearerr, fileno - stream status inquiries 
SYNOPSIS 

tinclude <stdio.h> 

£eo£(stream) 

FILE *stream; 

ferror(stream) 

FILE *streeun 

clearerr(stream) 

FILE *streeun 

£ileno(streeun) 

FILE *stream; 

DESCRIPTION 

Feof returns non-zero when end of file is read on the named 
input stream , otherwise zero. 

Ferror returns non-zero when an error has occurred reading 
or writing the named stream , otherwise zero. Unless cleared 
Glearerr , the error indication lasts until the stream is 
closed. 

Clrerr resets the error indication on the named stream . 

Fileno returns the integer file descriptor associated with 
the stream , see open (2). 

These functions are implemented as macros; they cannot be 
redeclared. 

SEE ALSO 

fopen(3), open{2) 
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NAME 

fabs, floor/ ceil 
SYNOPSIS 

tinclude <math.h> 

double floor(x) 
double xjj 

double ceil(x) 
double x; 

double £abs(x) 
double(x); 


absolute value. 


floor]. 


ceiling 


DESCRIPTION I 

Fabs returns the absolute value IjcI . 

Floor returns the largest integer not greater than 

Ceil returns the smallest integer not less than x. 

SEE ALSO 

abs(3) 



FLOOR(3M) 


functions 
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NAME 

fopen, freopen, fdopen - open a stream 
SYNOPSIS 

tlnclude <stdio.h> 

FILE *fopen(filename, type) 
char *filencune, *type; 

FILE *freopen(filename, type, stream) 
char *filename, *type; 

FILE *stream; 

FILE *fdopen(flldes, type) 
char *type; 

DESCRIPTION 

Fopen opens the file named by filename and associates a 
stream with it. Fopen returns a pointer to be used to 
identify the stream in subsequent operations. 

Type is a character string having one of the following 
values: 

"r” open for reading 
"w" create for writing 

"a" append: open for writing at end of file, or create for 
writing 

Freopen substitutes the named file in place of the open 
stream . It returns the original value of stream . The 
original stream is closed. 

Freopen is typically used to attach the preopened constant 
names, stdln, stdout, stderr, to specified files. 

Fdopen associates a stream with a file descriptor obtained 
from open , dup , creat , or pipe (2). The type of the stream 
must agree with the mode of the open file. 

SEE ALSO 

open(2), fclose(3) 

DIAGNOSTICS 

Fopen and freopen return the pointer NULL if filename cannot 
be accessed. 


BUGS 

Fdopen is not portable to systems other than UNIX. 
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NAME 


fread, fwrite - buffered binary input/output 


SYNOPSIS 

♦include <stdio.h> 

fread(ptr; sizeof(*ptr), nitems, stream) 

PILE *stream; 

fwrite(ptr, sizeof(*ptr), nitems, streeun) 

FILE *stream; 

DESCRIPTION 

Fread reads, into a block beginning at ptr » nitems of data 
of the type of * ptr from the named input 
the number of items actually read. 


Fwrite appends at most nit ems of data of 
beginning at ptr to the named output stre 
number of items actually written. 

SEE ALSO I 

read(2), Write(2), fopen(3), getc(3), puti2(3), gets(3), 
puts(3), printf(3), scanf{3) 

DIAGNOSTICS 

Fread and fwrite return 0 upon end of filje or error. 


FREAD(38) 


stream. It returns 


jthe type of * ptr 
am. It returns ttie 
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NAME 

frexpx Idexp, modf - split into mantissa and exponent 
SYNOPSIS 

double frexp(value, eptr) 
double value; 
int *eptr7 

double Idexp(value, exp) 
double value; 

double modf(value, iptr) 
double value, *iptr; 

DESCRIPTION 

Frexp returns the mantissa of a double value as a double 
quantity, x, of magnitude less than 1 and stores an integer 
n such that value = x*2**n indirectly through eptr . 

Ldexp returns the quantity value *2** exp . 

Modf returns the positive fractional part of value and 
stores the integer part indirectly through iptr . 
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NAME 


fseek, rewind - reposition a stredi 




SYNOPSIS 

♦include i<stdio.h> 

fseek (stream/ offset# ptmeune) 

FILE ‘stream; 
long offset; 

long £tell(stream) 

PILE ‘stream; 

rewind (streeun) 

DBSCRIPTION 

Fseek sets the position of the next input: or output 
operation on the stream . The new position is at the sign 
distance offset bytes from the beginning, the current 
position, or the end of the file, according as ptrname ha^ 
the valu^ 0, 1, or 2. 


FSEEK(3S) 


ffset relative to 
the named strearli 


Fseek undoes any effects of ungetc (3). 

I 

Ftell retiurns the current value of the 
the beginning of the file associated witl^ 

It is measured in bytes on UNIX; on some 
a magic cookie, and the only foolproof w 
offset for fseek. 

■ ~ i . " “ 

Rewind(stream) is equivalent to fseek ( stream , 0L, 0). 


other systems it 
’^y to obtain an 


4d 


xs 


SEE ALSO 

lseek(2), fopen(3) 

DIAGNOSTICS 

Fseek returns -1 for improper seeks. 
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NAME 

getc, getchar, fgetc, getw - get character or word from 
stream 


SYNOPSIS 

flnclude <stdio.h> 

int getc(stream) 
PILE ‘stream; 

int getchar() 

int fgetc(stream) 
FILE ‘streeim; 

int getw(streeun) 
PILE ‘streeun; 


DESCRIPTION 

Getc returns the next character from the named input stream . 
Getchar () is identical to getc ( stdin ). 


Fgetc behaves like getC / but is a genuine function, not a 
macro; it may be used to save object text. 


Getw returns the next word from the named input stream . It 
returns the constant EOF upon end of file or error, but 
since that is a good integer value, feof and ferror (3) 
should be used to check the success of getw . Getw assumes 
no special alignment in the file. 

SEE ALSO 

fopen(3), putc(3), gets(3), scanf(3), fread(3), ungetc(3) 
DIAGNOSTICS 

These functions return the integer constant EOF at end of 
file or upon read error. 

A stop with message, 'Reading bad file', means an attempt 
has been made to read from a stream that has not been opened 
for reading by fopen . 


BUGS 

The end-of-file return from getchar is incompatible with 
that in UNIX editions 1-6. 

Because it is implemented as a macro, getc treats a stream 
argument with side effects incorrectly. In particular, 
'getG(*f++);' doesn't work sensibly. 
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NAME 

getenv - value for environment name 
SYNOPSIS 

char *getenv (neune) 
char *name; 


DESCRIPTION 

Getenv searches the 
string of jthe form 
string is present. 


environment list (see 
name= » value and returns 
otherwise 0 (NULL). 


environ (5)) for a 
value if such a 


SEE ALSO 

environ(5), exec(2) 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent - get group 
file entry 

SYNOPSIS 

#include <grp.h> 

struct group *getgrent(); 

struct group *getgrgid(gid) int gid; 

struct group *getgrnaia(naine) char *neune; 

int setgrent(); 

int endgrent(); 

DESCRIPTION 

Getgrent ^ getgrgid and getgrnam each return pointers to an 
object with the following structure containing the broken- 
out fields of a line in the group file. 

struct group { /* see getgrent(3) */ 
char *gr_name 7 
char *gr_passwd; 
int gr_gid; 
char **gr mem; 


The members of this structure are; 
gr_name 

The name of the group. 
gr_j3asswd 

The encrypted password of the group. 
gr_gid 

The numerical group-ID. 
gr_raem 

Null-terminated vector of pointers to the individual 
member names. 

Getgrent simply reads the next line while getgrgid and 
getgrnam search until a matching gid or name is found (or 
until EOF is encountered). Each routine picks up where the 
others leave off so successive calls may be used to search 
the entire file. 

A call to setgrent has the effect of rewinding the group 
file to allow repeated searches. Endgrent may be called to 
close the group file when processing is complete. 


PILES 
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/etc/group 
SEE ALSO 

getlogin(3 )|, getpwent(3), group(5) 

DIAGNOSTICS 

A null pointer (3) is returned on EOF or error. 


BUGS 


All information is contained in a static area so it must be 
copied if it is to be saved. 
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NAME 

getlogin - get login name 


SYNOPSIS 

char *getlogin{); 


DESCRIPTION 

Getloqin returns a pointer to the login name as found in 
/ etc / utmp . It may be used in conjunction with getpwnam to 
locate the correct password file entry when the same userid 
is shared by several login names. 

If getloqin is called within a process that is not attached 
to a typewriter, it returns HULL. The correct procedure for 
determining the login name is to first call getlogin and if 
it fails, to call getpwuid . 


FILES 

/etc/utmp 
SEE ALSO 

getpwent(3), getgrent(3), utmp(5) 
DIAGNOSTICS 

Returns NULL (0) if name not found. 


BUGS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 

getpass - fead a password 
SYNOPSIS 

char *getpass(prompt) 
char *prompt; 


DESCRIPTION 

Getpass re^ds a password from the file /de 
cannot be opened, from the standard input, 
with the null-terminated string prompt and 
echoing. A pointer is returned to a null- 
of at most 3 characters. 


y/ tty , or if that 
after prompting 
disabling 
terminated string 


FILES 

/dev/tty 


SEE ALSO 

crypto) 


BUGS 


The return value points to static data who 
overwritten by each call. 


se content is 



) 
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NAME 

getpw - get name from UID 

SYNOPSIS 

getpw(uid, buf) 
char *buf; 

DESCRIPTION 

Getpw searches the password file for the (numerical) uid , 
and fills in buf with the corresponding line; it returns 
non-zero if uid could not be found. The line is null- 
terminated. 


FILES 

/ etc/pass\\;d 

SEE ALSO 

getpwent(3), passwd(5) 
DIAGNOSTICS 

Non-zero return on error. 
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NAME 


getpwent, getiiwuid, getpwnam, setpwent, ejidpwent - get 
password file entry 


SYNOPSIS 

tinclude <pwd.h> 

struct passwd *getpwent(); 

struct passwd *getpwuid(uid) int uid; 

struct paSswd *getpwnam(name) char *namej 

int setpwent(); 

int endpwent()? 

DESCRIPTION 

Getpwent, getpwuid and getpwnam each retu 
object with the following structure conta 

out fieldi of a line in the password file 

I 

struct passv/d { /* see getpwent(3 
char *pw_name; 
char *pw_joasswd; 
int pw_uid; 
int pw_gid; 
int pw_quota; 
char *pw_corament; 
ichar *pw_gecos; 
char *pw_dir; 
char *pw_shell; 

}; 

The fields pw quota and pw comment are unused; the othe 
have meanings described in passwd (5). 


rn a pointer to a^ 
kning the broken- 


) */ 


Getpwent reads the next line (openin 
necessary); setpwent rewinds the file; erv 


j ! 

Getpwuid and getpwnam search from the 
matching uid or name is found (or until E 


the file 
hpwent closes it 


rs 


if 


beginning until 
OF is encountered!) . 


FILES 


/etc/passwd 
SEE ALSO 

getlogin(3), getgrent(3), passwd(5) 

DIAGNOSTICS 

Null pointer (0) returned on EOF or error 
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BUGS 

All information is contained in a static area so it must 
copied if it is to be saved. 


be 
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NAME 


gets, fgetjs - get a string from a stream 


SYNOPSIS 

finclude <stdio.h> 

char *gets(s) 
char *s; 

char *fgets(s, n, stream) 
char *s; 

FILE *stream; 


DESCRIPTION 


GETS(3S) 


Gets reads a string into from the stand^ird input stream 
stdin. The string is terminated by a newljLne character, 
which is replaced in £ by a null charactep Gets returns 
its argument. 


Fqets reads n-1 characters, or up to a ne 
whichever comes first, from the stream in 
The last character read into £ is followe 


character: Fgets returns its first argument. 

ror(3) 


swline character, 
to the string £. 
k by a null 


SEE ALSO , , 

puts(3), getc(3), scanf(3), fread(3), fer 


DIAGNOSTICS . , ^ u 

Gets and fgets return the constant pointejr NULL upon end o^ 

file or eirror. 


BUGS 


' , I 

Gets deletes a newline, fgets keeps it, a 
backward compatibility. 


11 in the name of 
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NAME 

hypot, cabs - euclidean distance 
SYNOPSIS 

#include <math.h> 

double hypot(x, y) 
double X, y; 

double cabs(z) 

struct { double x, y;} z; 

DESCRIPTION 

Hypot and cabs return 

sqrt(x*x + y*Y), 

taking precautions against unwarranted overflows. 

SEE ALSO 

exp(3) for sgrt 
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NAME 

j0, jl, jh, y0, yl, yn - bessel functions 
SYNOPSIS 

#include <math.h> 

double j0(x) 
double x; 

double jl(x) 
double x;j 

double jn(n, x); 
double x; 

double y0(x) 
double x; 

double yl(x) 
double x;j 

double yn{n, x) 
double x;j 

DESCRIPTION , . , ^^ 

These functions calculate Bessel functions of the fitst arc 

second kinds for real arguments and integer orders. 
DIAGNOSTICS 

Negative arguments cause y0i yT, and yn to return a huge 
negative value and set errno to EDOM. 


Page 1 


(printed 8/22/83) 





L3TOL(3) 


Nu Machine UNIX Programmer * s Manual 


L3TOL(3) 


NAME 

13tol, ltol3 - convert between 3-byte integers and long 
integers 

SYNOPSIS 

13tol(lp/ cp, n) 
long *lp; 
char *cp; 

ltol3(cp. Ip, n) 
char *cp; 
long *lp; 

DESCRIPTION 

L3tol converts a list of n three-byte integers packed into a 
character string pointed to by cp into a list of long 
integers pointed to by Ip . 

Ltol 3 performs the reverse conversion from long integers 
(Ip) ^to three-byte integers (cp). 

These functions are useful for file-system maintenance; disk 
addresses are three bytes long. 

SEE ALSO 

filsys(5) 
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NAME 

malloc, free, realloc, calloc - main memory allocator 
SYNOPSIS 

char *malloc(size) 
unsigned size; 

free(ptr) 
char *ptr; 

char *realloc(ptr, size) 
char *ptr; 
unsigned size; 

char *callbc(nelem, elaize) 

unsigned nblem, elsize; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory 
allocation package. Malloc returns a pointer to a block of 
at least size bytes beginning on a word boundary. 

The argument to free is a pointer to a block previously 
allocated by mallo c; this space is made available for 
further allocation, but its contents are left undisturbed. 

Needless tjo say, grave disorder will result if the space 
assigned by malloc is overrun or if some random number is 
handed to free . 

Malloc allocates the first big enough cont^iguous reach of 
free space found in a circular search from the last block 
allocated br freed, coalescing adjacent free blocks as it 
searches. It calls sbrk (see break (2)) tO get more memory 
from the system when there is no suitable space already 
free. 

Realloc changes the size of the block poiriited to by ptr to 
size bytes and returns a pointer to the (jossibly moved) 
block. The contents will be unchanged up to the lesser of 
the new and old sizes. 

Realloc also works if ptr points to a blodk freed since the 
last call bf malloc , realloc or calloc ; thus sequences of 
free, malloc and reallqc can exploit the search strategy of 
malloc to do storage compaction. 

Calloc allocates space for an array of nelem elements of 
size elsize » The space is initialized to zieros. 

Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for 
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storage of any type of object. 

DIAGNOSTICS 

Malloc / realloc and calloc return a null pointer (0) if 
there is no available memory or if the arena has been 
detectably corrupted by storing outside the bounds of a 
block. Malloc may be recompiled to check the arena very 
stringently on every transaction; see the source code. 


BUGS 

When realloc returns 0, the block pointed to by ptr may be 
destroyed. 
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NAME 


mktemp - make a unique file name 


SYNOPSIS 

char *inkteihp(template) 
char *template; 

DESCRIPTION i 

Mktem p replaces template by a unique file 
the address of the template. The template 
a file name with six trailing X's, which 
with the current process id and a unique 


SEE ALSO 

getpid{2) 


MKTEMPO 


) 


jname/ and returns 
should look like 
ill be replaced 
letter. 
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NAME 

monitor - prepare execution profile 
SYNOPSIS 

monitor(lowpc, highpc, buffer# bufsize, nfunc) 
int (*lowpc)( ), (*highpc)( ); 
short bufferC 3; 

DESCRIPTION 

An executable program created by 'cc -p* automatically 
includes calls for monitor with default parameters; monitor 
needn't be called explicitly except to gain fine control 
over profiling. 

Monitor is an interface to profil (2). Lowpc and highpc are 
the addresses of two functions; buffer is the address of a 
(user supplied) array of bufsize short integers. Monitor 
arranges to record a histogram of periodically sampled 
values of the program counter, and of counts of calls of 
certain functions, in the buffer. The lowest address 
sampled is that of lowpc and the highest is just below 
highpc . At most nfunc call counts can be kept; only calls 
of functions compiled with the profiling option -p of cc(l) 
are recorded. For the results to be significant, especTally 
where there are small, heavily used routines, it is 
suggested that the buffer be no more than a few times 
smaller than the range of locations sampled. 

To profile the entire program, it is sufficient to use 

extern etext(); 

• • • 

monitor((int)2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text, see end (3). 

To stop execution monitoring and write the results on the 
file roon.out, use 


raonitor(0); 

then prof (I) can be used to examine the results. 


FILES 

mon.out 
SEE ALSO 

prof(l), profil(2), cc(l) 


Page 1 


(printed 8/22/83) 



nlistO) 


Nu Machine UNIX Progranimer' s Maikual 


NAME 


nlist - get entries from name list 


SYNOPSIS 

finclude <nlist.h> 
nlist(filename, nl) 
char *filename; 
struct nlist nl[ ]; 

DESCRIPTION 

Nlist exainines the name list in the given executable outpulj: 
file and Selectively extracts a list of values. The name 
list consists of an array of structures containing names, 
types and values. The list is terminated with a null name 
Each name is looked up in the name list of the file. If tljie 
name is found, the type and value of the name are inserted 
in the next two fields. If the name is n<pt found, both 
entries ate set to 0. See a. out (5) for tl;ie structure 
declaration. 

th 


NLIST(i) 


This subr(iutine is useful for examining 
kept in tlie file /unix. In this way prog 
system addresses that are up to date. 


e system name li^ 
rams can obtain 


SEE ALSO 

a.out(5) 


DIAGNOSTICS 

All type entries are set to 0 if the file 
if it is hot a valid namelist. 


cannot be found or 
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NAME 

perror, sys_errlist, sys_nerr - system error messages 

SYNOPSIS 

perror(s) 
char *s; 

int ays__nerr; 
char *sys_errlistC]; 

DESCRIPTION 

Perror produces a short error message on the standard error 
file describing the last error encountered during a call to 
the system from a C program. First the argument string £ is 
printed, then a colon, then the message and a new-line. 

Most usefully, the argument string is the name of the 
program which incurred the error. The error number is taken 
from the external variable errno (see intro (2)), which is 
set when errors occur but not cleared when non-erroneous 
calls are made. 

To simplify variant formatting of messages, the vector of 
message strings sys errlist is provided; errno can be used 
as an index in this table to get the message string without 
the newline. Sys nerr is the number of messages provided 
for in the table; it should be checked because new error 
codes may be added to the system before they are added to 
the table. 

SEE ALSO 

intro(2) 
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NAME 

plot: openpl et al. - graphics interface 

SYNOPSIS 

openpl( ) 

erase( ) 

label(s) char sC ]; 

llne(xl/ yl# x2, y2) 

circle(x, y,,r) 

arc(x, y, x0, y0, xl, yl) 

raove(x, y) 

cont(x, y) 

point(x, y) 

linemod(s) char sC 3; 

space(x0, y0, xl, yl) 

closepK ) 


in a relatively 


DESCRIPTION 

These subroutines generate graphic output! 
device-independent manner. See plot (5) for a description 
their effect. Openpl must be used before any of the other 
to open the device for writing. Closepl jflushes the outpu 


of 

s 

t. 


string arguments to label and 1inemod are 
and do not contain newlines. 


nul1-terminated, 


Various flavors of these functions exist for different 
output devices. They are obtained by the following ld(l) 
options: 


-Iplot 

-1300 

-1300s 

-1450 

-14014 


device-independent graphics 
output for plot (1) filters 
GSI 300 terminal 
GSI 300S terminal 
DASI 450 terminal 
Tektronix 4014 terminal 


stream on standard 


SEE ALSO 

plot(5), plot(l), graph(l) 


3) 
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NAME 

popen, pclose - initiate I/O to/from a process 
SYNOPSIS 

#include <stdio.h> 

FILE *popen(command , type) 
char *command, *type; 

pclose(stream) 

FILE *stream; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated 
strings containing respectively a shell command line and an 
l/o mode, either "r" for reading or "w" for writing. It 
creates a pipe between the calling process and the command 
to be executed. The value returned is a stream pointer that 
can be used (as appropriate) to write to the standard input 
of the command or read from its standard output. 

A stream opened by popen should be closed by pclose , vdiich 
waits for the associated process to terminate and returns 
the exit status of the command. 

Because open files are shared, a type "r" command may be 
used as an input filter, and a type "w" as an output filter. 

SEE ALSO 

pipe(2), fopen(3), fclose(3), system(3), wait(2) 

DIAGNOSTICS 

Popen returns a null pointer if files or processes cannot be 
created, or the Shell cannot be accessed. 

Pclose returns -1 if stream is not associated with a 
'popened' Command. 


BUGS 

Buffered reading before opening an input filter may leave 
the standard input of that filter mispositioned. Similar 
problems with an output filter may be forestalled by careful 
buffer flushing, e.g. with fflush, see fclose(3). 
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NAME 

printf, fprintf, sprintf - formatted output conversion 
SYNOPSIS 

tinclude <stdio.h> 

printf(format [, arg ] ••. ) 

char *format; 

fprintf(stream/ format [/ arg ] ... ) 

FILE *streeun; 
char *format 7 

aprintf(s/ format [/ arg ] ... ) 

char *s, format; 

DESCRIPTION 

Printf places output on the standard output stream stdout . 
Fprintf places output on the named output stream . Sprintf 
olaces 'output' in the string £, followed by the character 
' \0 • . 

Each of these functions converts, formatsi and prints its 
arguments after the first under control of the first 
argument. The first argument is a character string which 
contains two types of objects; plain characters, which are 
simply copied to the output stream, and conversion 
specifications, each of which causes conversion and printir.g 
of the next successive arg printf . 

Each conversion specification is introduced by the character 
%. Following the %, there may be 

an optional minus sign which specifies left 
adjustment of the converted value in the indicated 
field; 

an optional digit string specifying a field width ; if 
the converted value has fewer characi:ers than the fie].d 
width it will be blank-padded on the left (or right, i.f 
the left-adjustment indicator has been given) to make 
up the field width; if the field wid|:h begins with a 
zero, zero-padding will be done instead of blank¬ 
padding; 

an optional period '.' which serves to separate the 
field width from the next digit string; 

an optional digit string specifying a precision which 
specifies the number of digits to appear after the 
decimal point, for e- and f-conversion, or the maximum 
number of characters to be printed from a string; 
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- the character 1 specifying that a following d/ o, x, or 
u corresponds to a long integer arg . (A capitalized 
conversion code accomplishes the same thing.) 

- a character which indicates the type of conversion to 
be applied. 

A field width or precision may be instead of a digit 

string. In this case an integer arg supplies the field 
width or precision. 

The conversion characters and their meanings are 

dox The integer arg is converted to decimal, octal, or 
hexadecimal notation respectively. 

f The float or double arg is converted to decimal 

notation in the style C—]ddd.ddd' where the number of 
d‘s after the decimal point is equal to the precision 
specification for the argument. If the precision is 
missing, 6 digits are given; if the precision is 
explicitly 0, no digits and no decimal point are 
printed. 

e The float or double arg is converted in the style 
'[-]d.ddde+dd' where there is one digit before the 
decimal poTnt and the number after is equal to the 
precision specification for the argument; when the 
precision is missing, 6 digits are produced. 

g The float or double arg is printed in style d, in style 
f, or in style e, whichever gives full precision in 
minimum space. 

c The character arg is printed. Null characters are 
ignored. 

S Arg is taken to be a string (character pointer) and 
characters from the string are printed until a null 
character or until the number of characters indicated 
by the precision specification is reached; however if 
the precision is 0 or missing all characters up to a 
null are printed. 

u The unsigned integer arg is converted to decimal and 

printed (the result will be in the range 0 to 65535). 

% Print a no argument is converted. 

In no case does a non-existent or small field width cause 
truncation of a field; padding takes place only if the 
specified field width exceeds the actual width. Cliaracters 
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generated by printf are printed by putc (3). 

Examples 

To print a date and time in the form 'Sunday, July 3, 
10:02', where weekday and month are pointers to null- 
terminated strings: 


printf(■*%s, %s %d, %02d:%02d", 
hour, min); 


weekday. 


month, 


day. 


To print pi to 5 decimals: 

printf("pi = %.5f", 4*atan(1.0)); 


SEE ALSO 

puto(3), scanf(3), ecvt(3) 


BUGS 

Very wide fields (>128 characters) fail. 
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NAME 

putc, putchar, fputc, putw - put character or word on a 
stream 

SYNOPSIS 

♦include <stdio.h> 

int putc(c, stream) 
char c; 

FILE *strecun; 

putchar(c) 

fputc(c# stream) 

FILE *8tre€un; 

putw(w, streeim) 

FILE *stream; 

DESCRIPTION 

Putc appends the character c to the named output stream . It 
returns the character written. 

Putchar (c) is defined as putc (c, stdout ). 

Fputc behaves like putc, but is a genuine function rather 
than a macro. It may be used to save on object text. 

Putw appends word (i.e. int) w to the output stream . It 
returns the word written. Putw neither assumes nor causes 
special alignment in the file. 

Unlike the original version of stdio , the standard stream 
stdout is always buffered; this default may be changed by 
setbuf (3). The standard stream stderr is by default 
unbuffered unconditionally, but use of freopen (see 
fopen (3)) will cause it to become buffered; setbuf , again, 
will set the state to whatever is desired. When an output 
stream is unbuffered information appears on the destination 
file or terminal as soon as written; when it is buffered 
many characters are saved up and written as a block. Fflush 
(see fclose O)) may be used to force the block out early. 

In addition, all output streams associated with pipes or 
terminals are automatically flushed before requesting input 
from a pipe or terminal. 

SEE ALSO 

fopen(3), fclose(3), getc(3), puts(3), printf(3), fread(3) 
DIAGNOSTICS 

These functions return the constant EOF upon error. Since 
this is a good integer, ferror (3) should be used to detect 
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putw errors. 


BUGS 

Because it is implemented as a macro, putc treats a stream 
argument with side effects improperly. In particular 
'putc{c, *f++);' doesn't work sensibly. 
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NAME 

putc, putchar, fputc, putw - put character or word on a 
stream 

SYNOPSIS 

tinclude <stdio.h> 

int putc(c, stream) 
char c; 

FILE *stream; 

putchar(c) 

fputc(c, stream) 

FILE *stream; 

putw(w, stream) 

FILE ♦strecun; 

DESCRIPTION 

Putc appends the character c to the named output stream . It 
returns the character written. 

Putchar (c) is defined as putc (c, stdout ). 

Fputc behaves like putc, but is a genuine function rather 
than a macro. It may be used to save on object text. 

Putw appends word (i.e. int) w to the output stream . It 
returns the word written. Putw neither assumes nor causes 
special alignment in the file. 

The standard stream stdout is normally buffered if and only 
if the output does not refer to a terminal; this default may 
be changed by setbuf (3). The standard stream stderr is by 
default unbuffered unconditionally, but use of freopen (see 
fopen (3)) will cause it to become buffered; setbuf , again, 
will set the state to whatever is desired. When an output 
stream is unbuffered information appears on the destination 
file or terminal as soon as written; when it is buffered 
many characters are saved up and written as a block. Fflush 
(see fclose (3)) may be used to force the block out early. 

SEE ALSO 

fopen(3), fclose(3), getc(3), puts(3), printf(3), fread(3) 

DIAGNOSTICS 

These functions return the constant EOF upon error. Since 
this is a good integer, ferror (3) should be used to detect 
putw errors. 


BUGS 
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Because it is implemented as a macro, putc 
argument with side effects improperly. In 
'putc(c, *f++);' doesn't work sensibly. 


treats a stream 
particular 
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NAME 

putS/ fputs - put a string on a stream 
SYNOPSIS 

tinclude <stdio.h> 

puts(s} 
char *s; 

fputs(s, stream) 
char *s; 

FILE *stream; 

DESCRIPTION 

Puts copies the null-terminated string s to the standard 
output stream stdout and appends a newlTne character. 

Fputs copies the null-terminated string £ to the named 
output stream . 

Neither routine copies the terminal null character. 

SEE ALSO 

fopenO), gets(3), putc(3), printf(3), ferror(3) 
fread(3) for fwrite 

BUGS 

Puts appends a nev/line, fputs does not, all in the name of 
bacicward compatibility. 
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NAME 

qsort - quicker sort 
SYNOPSIS 

qsort(base, nel, width, compar) 

char *base; 

int (*compar)( ); 


DESCRIPTION 

Qsort is an implementation of the quicker 
The first argument is a pointer to the ba 
second is the number of elements; the thi 
an element in bytes; the last is the name 
routine to be called with two arguments w 
to the elements being compared. The rout 
integer less than, equal to, or greater tl 
the first argument is to be considered le 
or greater than the second. 


sort algorithm, 
be of the data; the 
ird is the width of 
of the comparison 
jhich are pointers 
ine must return an 
iian 0 according as 
ss than, equal to 


SEE ALSO 

sort(l) 
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NAME 

rand, srand - random number generator 

SYNOPSIS 

srand(seed) 
int seed; 

rand( ) 

DESCRIPTION 

Rand uses a multiplicative congruential random number 
generator with period 28329 to return successive pseudo-random 
numbers in the range from 0 to 28159-1. 

The generator is reinitialized by calling srand with 1 as 
argument. It can be set to a random starting point by 
calling srand with whatever you like as argument. 
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NAME 

scanf, fscanf, sscanf - formatted input conversion 
SYNOPSIS 

#include <stdio.h> 

scanf(format C , pointer ] . . . ) 

char *format; 

fscanf(stream, format [ , pointer ] . . . ) 

FILE *stream; 
char *format; 

sscanf(s, format [ , pointer ] . . . ) 

char *s, *format; 

DESCRIPTION 

Scanf reads from the standard input stree^m stdin . Fscanf 
reads from the named input stream . Sscanf reads from the 
character string £. Each function reads characters, 
interprets them according to a format, and stores the 
results in its arguments. Each expects as arguments a 
control string format , described below, and a set of pointer 
arguments indicating where the converted input should be 
stored. 

. The control string usually contains conversion 
specifications, which are used to direct interpretation of 
input sequences. The control string may contain: 

1. Blanks, tabs or newlines, which matct, optional white 
space in the input. 

2. An ordinary character (not %) which riust match the next 
character of the input stream. 

3. Conversion specifications, consistinc[ of the character 
%, an optional assignment suppressing character *, an 
optional numerical maximum field widt.h, and a conversion 
character. 

A conversion specification directs the conversion of the 
next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless assignment 
suppression was indicated by *. An input: field is defined 
as^ a string of non-space characters; it esxtends to the nex t 
inappropriate character or until the field width, if 
specified, is exhausted. 

The conversion character indicates the interpretation of the 
input field; the corresponding pointer argument must usually 
be of a restricted type. The following conversion 
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characters are legal; 

% a single is expected in the input at this point; no 
assignment is done. 

d a decimal integer is expected; the corresponding 
argument should be an integer pointer. 

o an octal integer is expected; the corresponding argument 
should be a integer pointer. 

X a hexadecimal integer is expected; the corresponding 
argument should be an integer pointer. 

3 a character string is expected; the corresponding 

argument should be a character pointer pointing to an 
array of characters large enough to accept the string 
and a terminating '\0'/ which will be added. The input 
field is terminated by a space character or a newline. 

c a character is expected; the corresponding argument 
should be a character pointer. The normal ship over 
space characters is suppressed in this case; to read the 
next non-space character, try '%ls'. If a field width 
is given, the corresponding argument should refer to a 
character array, and the indicated number of characters 
is read. 

§9f7 a floating point number is expected; the next field is 
converted accordingly and stored through the 
corresponding argument, which should be a pointer to a 
float. The input format for floating point numbers is 
an optionally signed string of digits possibly 
containing a decimal point, followed by an optional 
exponent field consisting of an S or e followed by an 
optionally signed integer. 

C indicates a string not to be delimited by space 

characters. The left bracket is followed by a set of 
characters and a right bracket; the characters between 
the brackets define a set of characters making up the 
string. If the first character is not circumflex 
the input field is all characters until the first 
character not in the set between the brackets; if the 
first character after the left bracket is the input 
field is all characters until the first character which 
is in the remaining set of characters between the 
brackets. The corresponding argument must x^oint to a 
character array. 

The conversion characters d, o and x may be capitalized or 

preceeded by 1 to indicate that a pointer to long rather 
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than to int is in the argument list. Similarly, the 
conversion characters e or f may be capitalized or preceded 
by 1 to indicate a pointer to double ratli er than to float • 
The conversion characters d, o and x may be proceeded by h 
to indicate a pointer to short rather than to int. 

The scanf functions return the number of successfully 
matched and assigned input items. This can be used to 
decide how many input items were found. The constant EOF is 
returned upon end of input; note that this is different from 
0, which means that no conversion was dor.e; if conversion 
was intended, it was frustrated by an inappropriate 
character in the input. 

For example, the call 

int i; float x; char name[50]; 
scanf( "%d%f%s", Sei, &x, name); 

with the input line 

25 54.32E-1 thompson 

will assign to _i the value 25, x the value 5.432, and name 
will contain * thompson\0 *. Or, 

int i; float x; char name[50]; 

scanf ("%2d%f%*d%Cl234567890]'', &i, &x, name); 

with input 

56789 0123 56a72 

will assign 56 to i, 789.0 to x, skip '0123', and place tie 
string '56\0’ in name . The next call to getchar will return 


CPT? AT.CSn 

atof(3), getc(3), printf(3) 

DIAGNOSTICS 

The scanf functions return EOF on end of input, and a shoit 
count for missing or illegal data items. 

BUGS 

The success of literal matches and suppressed assignments is 
not directly determinable. 
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NAME 

setbuf - assign buffering to a stream 

SYNOPSIS 

tinclude <stdio.h> 


setbuf(stream, buf) 

FILE *stream; 
char *buf; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it 
is read or written. It causes the character array buf to be 
used instead of an automatically allocated buffer. If buf 
is the constant pointer NULL, input/output will be 
completely unbuffered. 

A manifest constant BUFSIZ tells how big an array is needed: 
char buf [BUFSIZ]; 

A buffer is normally obtained>from malloc (3) upon the first 
getc or putc (3) on the file, except that output streams 
directed to terminals, and the standard error stream stderr 
are normally not buffered. 

SEE ALSO 

fopen(3), getc(3), putc(3), malloc(3) 
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NAME 


setjmp, longjmp - non-local goto 


SYNOPSIS 

#include <setjmp.h> 

setjmp(env) 
jmp_buf env; 

longjmp(env, val) 
jmp_buf env; 

DESCRIPTION 

These routines are useful for dealing with 
interrupts encountered in a low-level subrj' 
program. 

Setjmp saves its stack environment in env 
longjmp . It returns value 0. 


Longimp restores the environment saved by the last call of 
setjmp . It then returns in such a way that execution 
continues as if the call of setjmp had just returned the 
value val to the function that invoked setjmp / vdiich must 


SETJMP(3) 


errors and 
loutine of a 


for later use by 


not itself have returned in the interim, 
data have values as of the time longjmp wa| 


|All accessible 
s called. 


SEE ALSO 

signal(2) 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric 
functions 

SYNOPSIS 

finclude <math>h> 

double sin(x) 
double x; 

double cos(x) 
double x; 

double asln(x} 
double x; 

double acos(x) 
double x; 

double atan(x) 
double x; 

double atan2(x, y) 
double X, y; 

DESCRIPTION 

Sin , cos and tan return trigonometric functions of radian 
arguments. The magnitude of the argument should be checked 
by the caller to make sure the result is meaningful. 

Asin returns the arc sin in the range -j/2 to j/2. 

Acos returns the arc cosine in the range 0 to J. 

Atan returns the arc tangent of x in the range -J/2 to J/2. 

Atan2 returns the arc tangent of x/j^ in the range -J to J. 

DIAGNOSTICS 

Arguments of magnitude greater than 1 cause asin and acos to 
return value 0; errno is set to EDOM. The value of tan at 
its singular points is a huge number, and errno is set to 
ERANGE. 

BUGS 

The value of tan for arguments greater than about 2**31 is 
garbage. 
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NAME 

sinh, cosh, tanh -• hyperbolic functions 
SYNOPSIS 

#include <math.h> 

double sinh(x) 
double x; 

double cosh(x) 
double x; 

double tanh(x) 
double x; 


M) 


DESCRIPTION 

These functions compute the designated hjj^perbolic functior|s 
for real arguments. 

DIAGNOSTICS 

Sinh and cosh return a huge value of appijropriate sign wheij 
the correct value would overflow. 
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NAME 

sleep - suspend execution for interval 

SYNOPSIS 

sleep(seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the 
number of seconds specified by the argument. The actual 
suspension time may be up to 1 second less than that 
requested, because scheduled wakeups occur at fixed 1-second 
intervals, and an arbitrary amount longer because of other 
activity in the system. 

The routine is implemented by setting an alarm clock signal 
and pausing until it occurs. The previous state of this 
signal is saved and restored. If the sleep time exceeds the 
time to the alarm signal, the process sleeps only until the 
signal would have occurred, and the signal is sent 1 second 
later. 

SEE ALSO 

alarm(2), pause(2) 
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NAME 


stdio - standard buffered input/output package 


SYNOPSIS 

#include <stdio.h> 

FILE *stdin; 

FILE *stdout; 

FILE *stderr 7 

DESCRIPTION 

The functions described in Sections 3S con: 
efficient user-level buffering scheme. The 
getc and putc (3) handle characters quickly. 

level routines getS / fgetS / scanf ^ fscanf » _ _ 

fputs , printf , fprintf , fwrite all use get<|! and putc ; they 
can be freely intermixed. 


stitute an 

in-line macros 
The higher 
fread/ puts. 


a stream / and is 
FILE. Fopen (3) 
am and returns a 
her transactions .1 
constant pointer^ 
with the 


A file with associated buffering is called 
declared to be a pointer to a defined type 
creates certain descriptive data for a str^ 
pointer to designate the stream in all furt 
There are three normally open streams with 
declared in the include file and associate^ 
standard open files: 

stdin standard input file 

stdout standard output file 

stderr standard error file 

A constant 'pointer* NULL (0) designates no stream at all 

An integer constant EOF (-1) is returned upon end of file oij 
error by integer functions that deal with sitreams. 

Any routine that uses the standard input/output package must 
include the header file <stdio.h> of pertir^ent macro 
definitions. The functions and constants mentioned in 
sections labeled 3S are declared in the include file and 
need no further declaration. The constants/ and the 
following 'functions' are implemented as macros; 
redeclaration of these names is perilous: getC / getchar / 
putC / putchar / feof / ferror , fileno . 

SEE ALSO 

open(2)/ close(2)/ read{2)/ write(2) 

DIAGNOSTICS 

‘Phe value EOF is returned uniformly to ind:|. 
pointer has not been initialized with fopep 


has been attempted on an output (input 1 iti^ 
pointer designates corrupt or otherwise un 


cate that a FILE 
input (outi^ut) 
earn/ or a FILE 
intelligible FILE 
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NAME 

strcat, strncat, strcrap, strncmp, strcpy, strncpy, strlen, 
index, rindex - string operations 

SYNOPSIS 

char *strcat(sl, s2) 
char *sl, *s2; 

char *strncat(sl, s2, n) 
char *sl, *s2; 

strcmp(sl, s2) 
char *sl, *s2; 

strncmp(sl, s2, n) 
char *sl, *s2; 

char *strcpy{sl, s2) 
char *sl, *s2; 

char *strncpy(sl, s2, n) 
char *sl, *s2; 

strlen(s) 
char *s; 

char *index(s, c) 
char *s, c; 

char *rindex(s, c) 
char *s; 

DESCRIPTION 

These functions operate on null-terminated strings. They do 
not check for overflow of any receiving string. 

Strcat appends a copy of string ^ to the end of string si . 
Strncat copies at most n characters. Botti return a pointe:: 
to the null-terminated result. 

Strcmp compares its arguments and returns an integer greater 
than, equal to, or less than 0, according as £l is 
lexicographically greater than, equal to, or less than s2 . 
Strncmp makes the same comparison but looks at at most n 
characters. 

Strcpy copies string £2 to £l, stopping after the null 
character has been moved. Strncpy copies exactly in 
characters, truncating or null-padding £2; the target may 
not be null-terminated if the length of sj2 is n or more. 

Both return si. 
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Strlen returns the number of non-null characters in s. 

Index ( rindex ) returns a pointer to the first (last) 
occurrence of character c in string or zero if c does not 
occur in the string. 

BUGS 
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NAME 


swab - swap bytes 


SYNOPSIS 

swab{from, to, nbytes) 
char *from, *to; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by froji 
pointed to by to, exchanging adjacent even 


It is useful for carrying binary data betW' 
machine types. IiTbytes should be even. 


n to the position 
and odd byte s. 
ben different 


SWAB (3 ) 
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NAME 

system - issue a shell command 

SYNOPSIS 

system(string) 
char *string; 

DESCRIPTION 

System causes the string to be given to ^(1) as input as if 
the string had been typed as a command at a terminal. The 
current process waits until the shell has completed, then 
returns the exit status of the shell. 


SEE ALSO 

popen(3), exec(2), wait(2) 

DIAGNOSTICS 

Exit status 127 indicates the shell couldn't be executed. 
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NAME 


tgetent, tgetnum, tgetflag, tgetstr, tgoto 
independent operation routines 


, tputs - terminal 


SYNOPSIS 

char PC; 
char *BC; 
char *UP; 
short ospeed; 

tgetent(bp, name) 
char *bp, *name 7 

tgetnum(id) 
char *id; 

tgetflag(id) 
char *id; 

char * 

tgetstrCid, area) 
char *id, **area; 

char * 

tgoto(cm, destcol# destline) 
char *cra 7 

tputs(cp# affcnt, outc) 
register char *cp 7 
int affcnt; 
int (*outc)()7 

DESCRIPTION 

These functions extract and use capabilities from the 
terminal capability data base termcap (5). 
level routines; see curses(3) for a higher 


Tqetent extracts the entry for terminal name into the buffe 


These are low 
level package. 


at ^ should be a character buffer of size 1024 and mus 

be retained through all subsequent calls tp tgetnum , 
tgetflag , and tgetstr . Tgetent returns -1 
the termcap file, 0 if the terminal name g| 
an entry, and 1 if all goes well. It will 
environment for a TERMCAP variable. If foj 
does not begin with a slash, and the termi 


if it cannot open 
iven does not hav 
look in the 
jund, and the valu 
pal type neune is 


the same as the environment string TERM, the TERMCAP string 


is used instead of reading the termcap filj 
begin with a slash, the string is used as 
than / etc / termcap . This can speed up entry 
that call tgetent , as well as to help debu 
descriptions or to make one for your termi 
write the file / etc / termcap 


je. If it does 
a path, name rathe 
into programs 
!g new terminal 
jnal if you can't 
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Tqetnum gets the numeric value of capability returning 

-1 if is not given for the terminal. Tgetflag returns 1 if 
the specified capability is present in the terminal's entry, 
0 if it is not. Tgetstr gets the string value of capability 
id , placing it in the buffer at area , advancing the area 
pointer. It decodes the abbreviations for this field 
described in termcap (5), except for cursor addressing and 
padding information. 

Tqoto returns a cursor addressing string decoded from cm to 
go to column destcol in line destline . It uses the external 
variables UP (from the up capability) and BC (if be is given 
rather than bs) if necessary to avoid placing \n, '*’D or 
in the returned string. (Programs which call tgoto should 
be sure to turn off the XTABS bit{s), since tgoto may now 
output a tab. Note that programs using termcap should in 
general turn off XTABS anyway since some terminals use 
control I for other functions, such as nondestructive 
space.) If a % sequence is given which is not understood, 
then tgoto returns OOPS. 

Tputs decodes the leading padding information of the string 
cp ; affent gives the number of lines affected by the 
operation, or 1 if this is not applicable, outc is a routine 
which is called with each character in turn. The external 
variable ospeed should contain the output speed of the 
terminal as encoded by stty (2 ). The external variable PC 
should contain a pad character to be used (from the pc 
capability) if a null ('^Q) is inappropriate. 

FILES 

/usr/lib/libtermcap.a -Itermcap library 
/etc/termcap data base 

SEE ALSO 

ex(l), curses(3), termcap(5) 

AUTHOR 

William Joy 

BUGS 
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al 


NAME 


ttyname, isatty, ttyslot - find name of a terminal 


SYNOPSIS 

char *ttyname(fildes) 

isatty(fildes) 

ttyslot() 

DESCRIPTION 

Ttyname returns a pointer to the null-termij 
of the terminal device associated with fil^ 
fildes « 

Isatty returns 1 if fildes is associated wi 
device, 0 otherwise. 

Ttyslot returns the number of the entry in 


for the control terminal of the current process. 


|nated path name 
descriptor 


th a terminal 


the ttys (5) file 


FILES 

/dev/* 

/etc/ttys 

SEE ALSO 

ioctl(2), ttys(5) 

DIAGNOSTICS 

Ttyname returns a null pointer (0) if fildes does not 
describe a terminal device in directory ' /^clev' . 

Ttyslot returns 0 if '/etc/ttys' is inaccessible or if it 
cannot determine the control terminal. 


BUGS 


The return value points to static data whose content is 
overwritten by each call. 


Page 1 


(printed 8/24/83) 




UNGETCOS) 


Nu Machine UNIX Programmer's Manual 


UNGETC{3S) 


NAME 

ungetc - push character back into input stream 
SYNOPSIS 

finclude <stdio.h> 

ungetc(c/ stream) 

FILE *stream 7 

DESCRIPTION 

Ungetc pushes the character c back on an input stream. That 
character will be returned by the next getc call on that 
stream. Ungetc returns c. 

One character of pushback is guaranteed provided something 
has been read from the stream and the stream is actually 
buffered. Attempts to push EOF are rejected. 

Fseek (3) erases all memory of pushed back characters. 

SEE ALSO 

getc(3), setbuf{3), fseek(3) 

DIAGNOSTICS 

Ungetc returns EOF if it can't push a character back. 
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NAME 

dk - MultiBus disk interface 
DESCRIPTION 

Devices with minor device numbers 0 through 7 refer to 
various partitions of drive 0. The standard device names 
begin with "dk" followed by the drive number and then a 
letter a-h for partitions 0-7 respectively. 

THe block devices access the the disk via the normal system 
buffering mechanism and may be read and written without 
regard for physical disk records. There is also a raw 
interface which provides for direct transmission between the 
disk and the user's read or write buffer. A single read or 
write call generally results in exactly one io operation and 
is therefore considerably more efficient when many words are 
transmitted. The names of the raw devices begin with an 
extra * r'. 

In raw io, counts should be multiples of 1024 bytes (a disk 
sector). Likewise, seek calls should specify a multiple of 
1024 bytes. 


DISK SUPPORT 

The driver handles both the Fujitsu Eagle and the Fujitsu 
Micro disks. The origin and size of. all the logical disks 
on the drive are as follows; 


Fujitsu 

Eagle 

(500 sectors/cyl = 7 d000 

bytes/cyl) 

device 

name 

cylinders 

(inclusive) 

size 

(sectors) 

length 
(bytes) 

offset 

(bytes) 

(none) 

0 

23 

5C00 

0 

rdkOa 

1-16 

7942 

7C1800 

7D000 

rdk0b 

17 - 83 

33440 

20A8000 

84D000 

rdkOc 

0 - 839 

420000 

19A28000 

0 

rdk0d 

376 - 391 

7942 

7C1800 

B798000 

rdkOe 

392 - 447 

27968 

1B50000 

BF68000 

rdk0f 

448 - 839 

196000 

BF68000 

DAC0000 

rdkUg 

376 - 839 

232000 

E290000 

B798000 

rdkOh 

84 - 375 

145673 

8E42400 

2904000 
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(none) 840 - 842 1500 


17 


7000 


19A 


28000 


Fujitsu Microdisk 


device 

name 

cylinders 

(inclusive 

(none) 

0 


rdk0a 

1 - 

64 

rdk0b 

65 - 

• 197 

rdk0G 

0 - 

586 

rdk0d 

198 

- 261 

rdk0e 

262 

- 483 

rdk0f 

484 

- 586 

rdk0g 

262 

- 586 

(none) 

587 

- 589 


(126 sectors/c 


yl = 1F800 bytes/ 


pyl) 


size 

(sectors) 
23 

7942 

16720 

73962 

7942 

27968 

12978 

40950 

378 


length 
(bytes) 


:00 
:i800 
154000 
i3A800 
:1800 
}50000 
CAC800 
27FD800 
5E800 


5C 

7C 

10 

48 

7C 

IB 


offset 
(bytes) 


0 

1F8 

7FF 

0 

185 

203 

3B8 

203 

483 


30 

300 

D000 

9000 

e:000 

■>000 

.\800 


FILES 

/dev/dk0Ca-h] block devices 

/dev/rdk0Ca-h3 raw devices 


BUGS 


In raw io, byte counts and file offsets ar 
1024-byte block boundaries. If count 
multiples of 1024-bytes are used, unwanted 
Thus, any programs access^-ng the -raw d 
write, and lseek(2) should always dea 
multiples. 


e rounded up to 
s which are not 
io will result, 
evices using read, 
1 in 1024-byt2 
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NAME 

mem, kmem core memory 

DESCRIPTION 

Mem is a special file that is an image of the core memory of 
the computer. It may be used, for example, to examine, and 
even to patch the system. Kmem is the same as mem except 
that kernel virtual memory rather than physical memory is 
accessed. 

Byte addresses are interpreted as memory addresses. 
References to non-existent locations return errors. 

Examining and patching device registers is likely to lead to 
unexpected results when read-only or write-only bits are 
present. 

On PDPll's, the l/O page begins at location 0160000 of kmem 
and per-process data for the current process begins at 
0140000. 


FILES 

/dev/mem, /dev/kmem 
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NAME 


mouse - optical mouse driver 


DESCRIPTION 

The mouse driver provides an interface to 
The mouse data consists of an x-position 
switch states. The mouse driver maintairli 
and provides a signal (SIGMOUS) when any 
changes. 

The mouse must be opened before use, whii 
signals. The process which opens the raovji 
process which will get the signals. When 
it is available for other pocesses. 


The mouse data may be sampled at any time using an ioctl 
call (WIOCRDMS). The ioctl returns a long: bits 0-11 
contain the 2's compliment of the current^, x position, bit^ 
16-27 contain the 2‘s compliment of the current y position, 
bit 12 is the state of the right switch ^0=depressed), bit 

13 is the state of the middle switch (0=(iepressed), and bit 

14 is the state of the left switch (0=depressed). All other 
bits are not used and should be masked ovkt. 


an optical mous4 
y-position, and 
s the mouse data 
of the data 


ih enables the 
se is the only 
the mouse is closed 


The mouse driver is designed for use witl^ 
Corporation M-1 Mouse. The mouse should 
baud, non-rotatable, self-test disabled, 
lines, normal, and TTL interface (switche 
others off). 


FILES 


/dev/mouse (character device, major=5, 
#include <ioctl.h> 

#include <signal.h> 


minor=0) 


a Mouse Systems 
le. set for 1200 
vertical blue 
s 4 and 6 on, allj 
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NAME 

newtty - a new terminal interface 

SYNOPSIS 

stty new 

DESCRIPTION 

This section describes a new terminal interface, which is 
available as a replacement for that described in tty (4). It 
is necessary to use this terminal interface to take 
advantage of the full process control power of csh(l), as it 
is not possible to generate the signals necessary to stop 
processes gracefully from a keyboard controlled by the 
discipline described in tty (4)« This interface provides 
''better'* editing functionality over terminal input than 
does tty (4) extracting its price in added complexity. 

To enable the discipline in a program, one uses the TIOCSETD 
ioctl , e.g.: 

♦include <sgtty.h> 

int Idisc = NTTYDISC; 

ioctl(0, TIOCSETD, &Idisc); 

Replacing TIOCSETD with TIOCGETD will yield in Idisc the 
current discipline, which will be either 0 (if tty(4) is 
being used), NETDISC if ^(4) is being used, or OTTYDISC. 

The file / dev / tty is, in each process, a synonym for the 
control terminal associated with that process. It is useful 
for programs that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can 
also be used for programs that demand a file name for 
output, when typed output is desired and it is tiresome to 
Eind out which terminal is currently in use. 

As for terminals in general; all of the low-speed 
asynchronous communications ports use, by default, the same 
general interface, no matter what hardware is involved. 

That interface is described in tty (4). The interface 
described in ]^(4) is used for networking applications, and 
whenever high-speed input must be presented to the machine. 
This newtty interface described here provides the features 
of tty (4j and also additional features required for the job 
control mechanisms provided by csh (l). It also provides 
input editing functions and options not found in tty (4); 
these functions are reminiscent of those provided on other 
systems such as TOPS-20. 

N.B.; This line discipline is provided in support of the 
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mechanisms of csh(l). Its default mode is highly compatitle 
with the standard UNIX version 7 tty dri\'er, tty (4 ), but 
programs which are written to require feeitures of this 
driver are less portable than they would be if they could 
make do without them. 

The remainder of this section discusses the common feature s 
of the interface; the presentation parallels that of tty (4). 

VThen a terminal file is opened, it causes the process to 
wait until a connection is established. In practice user’s 
programs seldom open these files; they ai‘e opened by init 
and become a user's input and output files. The very first 
terminal file open in a process becomes the control termiral 
for that process, and the systein establishes a process grcup 
consisting initially of that single process, associating 
this group with the terminal. The control terminal's 
process group plays a special role in handling the quit, 
interrupt, and stop signals, as discussed below. The 
control terminal is inherited by a child process during a 
fork , even if the control terminal is closed. The set of 
processes which are in the process group associated with the 
terminal receive certain signals togethei', as described 
below and also in kill (2). 

By moving sets of related processes in and out of the 
terminals process group with setpgrp (2), shells can allow 
the user to arbitrate between these difftsrent jobs. The 
terminal driver aids this arbitration by sending a SIGTTI^ 
signal to the process group of a process which attempts to 
read from its control terminal while it j.s not in the 
terminals process group. If the action for the SIGTTIN 
signal is SIG_IGN or SIG_HOLD, then no si.gnal is sent; 
instead the process gets an end-of-file on the read. A 
signal SIGTTOU exists and has a similar function for outpi.t. 
The default, however, is to allow background processes to 
produce output. They are stopped only if the local tty 
option bit TOSTOP is set. (If the process chooses to ignore 
or hold SIGTTOU signals while the TOSTOP bit is set, then 
the output is simply discarded; it is not clear that this is 
a reasonable thing to do, but it is hard to know what to cio 
in this situation.) 

A terminal associated with one of these Jiiles ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only losit 
when the system's character input buffers become completely 
choked, which is rare, or when the user has accumulated tlie 
maximum allowed number of input characteirs that have not yet 
been read by some program. Currently th;.s limit is 256 
characters. IVhen the input limit is reached further 
characters are ignored and the system rings the terminal 
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bell to warn that no more buffer space is available. 

Normally, terminal input is processed in units of lines. 

This means that a program attempting to read will be 
suspended until an entire line has been typed. Also, no 
matter how many characters are requested in the read call, 
at most one line will be returned. It is not however 
necessary to read a whole line at once; any number of 
characters may be requested in a read, even one, without 
losing information. There are special modes, discussed 
below, that permit the program to read each character as 
typed without waiting for a full line, or to be informed by 
a SIGTINT interrupt whenever data is available to read. 

During input, erase and kill processing is normally done. 

By default, either a '#' or a backspace (control-H) 
character erases the last character typed, except that it 
will not erase beyond the beginning of a line or an EOT. By 
default, either the character or the character NAK 
(control~U) kills the entire line up to the point where it 
was typed, but not beyond an EOT. These characters operate 
on a keystroke basis independently of any backspacing or 
tabbing that may have been done. Each of them may be 
entered literally by preceding it by the erase or kill 

character remains, but the disappears. These characters 
may be changed to others. The intention in providing two 
erase and two kill characters is that the characters and 
'‘U should always be available. The default '#’ and 
characters are often eliminated so that these characters can 
be typed normally, or to provide a different erase or kill 
character which a particular user likes. 

TVhen desired, all upper-case letters are mapped into the 
corresponding lower-case letter. The upper-case letter may 
be generated by preceding it by '\', and upper-case letters 
are printed preceded by '\‘ on output. In addition, the 
following escape sequences can be generated on output and 
accepted on input: 

for use 

\' 

1 \i 


Besides H and some other ASCII control characters have 
special meaning. These characters are not passed to a 
reading program except in raw mode where they lose their 
special character, or when typed immediately after the 
literal next character, normally ^V. Also, it is possible 
to change these characters from the default; see below. 
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ETB 


EOT 


DEL 


STX 


EM 


SUB 


DC 2 


US 
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(Control-V7) erases the preceding word 
spaces before it). A word^is a sequ^ 
characters (tabs count as ''blank'' h 


a 


(Control-D) may be used to generate 
a terminal. T'Then an EOT is received, 
characters waiting to be read are imni 
the program, without waiting for a n^ 
EOT is discarded. Thus if there are 
waiting, which is to say the EOT occ 
beginning of a line, zero characters 
back, and this is the standard end-of 
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(but not any 
nee of non-blank 
ere.) 


frqi 


n end of file 
all the 

ediately passed 
w-line, and the 
no characters 
urred at the 
will be passed 
-file indication.! 


(Rubout) is not passed to a program l:|>ut generates an 
interrupt signal which is sent to all processes in th^ 
process group of the control terminal 
such process is forced to terminate, 
may be made either to ignore the sigrkal or to receive 
trap to an agreed-upon location. Se^ signal (2). 


(Control-C) also generates an interr 
for DEL. Some users may make DEL an 
but '‘C should normally work on all t 
the user (impolitely) changes both i 
characters. 


upt as a synonym 
erase character, 
^rminals, unless 
nterrupt 


(Control^Z) is not passed to a program but generates a 


stop signal (SIGTSTOP) which is sent 
in the process group of the controll 
normally suspending the current job, 
placed in the background or another 
The job can later be continued or ki 
facilities of the shell. 

(Control-Y) generates a SIGTSTOP sig 
the signal is sent when a program tr 
rather than when it is typed. 


to all processes 
jLng terminal, 
so that it may b^ 
jjob may be run. 
lied using 


hal as ■'Z does, 
es to read the 


(Control-R) retypes the pending inpu|:. 
(Retyping automagically occurs if cha 
would normally be erased from the sc 
program output.) 


the 


SYN 


(Control-0) flushes the output to 
any character is typed, or a program 
terminal. Programs (such as the she 
prompts often clear the state set by 
prompt will appear. 

(Control-V) is a causes the next cha 
taken literally. It has no special 
character may be input in this way. 


b ik¬ 


on a new line, 
.racters which 
teen are fouled 


by 


terminal until 
reads from the 
jll) which print 
0 so that their 


racter input to b 
function. Any 
including ^V. 


(printed 8/22/83) 


m 

o 



NEWTTY(4) 


Nu Machine UNIX Programmer's Manual 


NEWTTY(4) 


FS (Control-\ or control-shift-L) generates the quit 

signal. Its treatment is identical to the interrupt 
signal except that unless a receiving process has made 
other arrangements it will not only be terminated but a 
core image file will be generated. 

DC3 (Control-S) delays all printing on the terminal until 
something is typed in. 

DCl (Control-Q) restarts printing after DC3 without 
generating any input to a program. 

'/Then the carrier signal from the dataset drops (usually 
because the user has hung up his terminal) a hangup signal 
is sent to all processes with the terminal as control 
terminal. Unless other arrangements have been made, this 
signal causes the processes to terminate. If the hangup 
signal is ignored/ any read returns with an end-of-file 
indication. Thus programs that read a terminal and test for 
end-of-file on their input can terminate appropriately when 
hung up on. 

Tihen one or more characters are written, they are actually 
transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are 
echoed by putting them in the output queue as they arrive. 
When a process produces characters more rapidly than they 
can be typed, it will be suspended when its output queue 
exceeds some limit. When the queue has drained down to some 
threshold the program is resumed. Even parity is always 
generated on output. The EOT character is not transmitted 
(except in raw or cbrealc mode) to prevent terminals that 
respond to it from hanging up. 

Several ioctl (2) calls apply to terminals. The standard 
calls are described in tty (4) and will not be repeated here. 
Additional functions provided by this interface use bits in 
a local mode word, described in <ioctl.h> as follows: 


LCRTBS 

000001 

LPRTERA 

000002 

LCRTERA 

000004 

LTIFjDE 

000010 

LMDMBUF 

000020 

LLITOUT 

000040 

LTOSTOP 

000100 

LFLUSHO 

000200 

LNOHANG 

000400 

LETXACK 

001000 

LCRTKIL 

002000 

LINTRUP 

004000 

LCTLECH 

010000 


Backspace on erase rather than echoing erase 
Printing terminal erase mode 

Erase character echoes as backspace-space-backspac 

Convert ~ to ' on output (for Hazeltine terminals) 

Stop/start output when carrier drops 

Suppress output translations 

Send SIGTTYO for background output 

Output is being flushed 

Don't send hangup when carrier drops 

Diablo style buffer hacking (unimplemented) 

BS-space-BS erase entire line on line kill 

Generate interrupt SIGTINT when input ready to rea 

Echo input control chars as ^X, delete as 
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LPENDItl 020000 Retype pending input at next read or input charau- 
The applicable ioctl functions are; 

TIOCLBIS 

arg is a (integer) mask which is the bits to be set in 
the local mode word. 


TIOCLBIC 

arg is a mask of bits to be cleared. 

TIOCLSET 

arg is a new mask to be placed in the local mode word. 


TIOCLGET 

arg is the address of a word which the current mask is 
placed in. 

TIOCSBRK 

the break bit is set in the terminal. 

TIOGCBRK 

the break bit is cleared. 

TIOCSDTR 

data terminal ready is set. 

TIOCCDTR 

data terminal ready is cleared. 

TIOCGPGRP 

arg is the address of a word into which is placed the 
process group number of the current terminal. 

TIOCSPGRP 

args is a word (typically a process id) which becomes 
the process group for the control terminal. 

TIOCSLTC 

args is the address of a Itchars structure which 
defines the new local special characters. 


TIOCGLTC 

args is the address of a Itchars structure into which 
is placed the current set of local special characters. 

FIONREAD 

returns in the long integer whose address is arg the 
number of immediately readable characters from the 
argument unit. This works for files, pipes, and 
terminals, but not (yet) for multiplexed channels. 
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The Itchars structure is defined by: 

struct Itchars { 

char t_suspc; /* 
char t_dstopc; /* 
char t_rprntc; /* 
char t^flushc; /* 
char t_werasec; 
char t_lnextc; /* 
char t_lerasec; 
char t_lkill; 
char t lintr; /* 


The default values for these characters are *'Y, '‘R, '‘O, 

''W, ‘'V, '“H, and (delete) . A value of -1 disables the 
character. 

PILES 

/dev/tty 
/dev/tty* 

/dev/console 

SEE ALSO 

getty(8), stty (1), signal(2), ioctl(2), bk(4), tty(4) 

BUGS 

The output flush character '‘O incorrectly flushes input as 
well. 


stop process signal */ 
delayed stop process signal */ 
reprint line */ 
flush output (toggles) */ 

/* word erase */ 
literal next character */ 

/* local erase */ 

/* local kill */ 
local interrupt */ 
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NAME 

null - data sink 


DESCRIPTION 

Data written on a null special file is discarded. 
Reads from a null special file always return 0 bytes 


FILES 

/dev/null 


NULL(4) 
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NAME 

tm - MultiBus magtape interface 
DESCRIPTION 

The files mt3 and mt4 refer to the half-inch Cipher magtape 
drive. The file mt0 is rewound when it is closed, the file 
mt4 is not. Yfhen a file open for writing is closed, two 
end-of-file marks are written. If the tape is not to be 
rewound it is positioned with the head between the two 
marks. 


A standard tape consists of a series of 1024-byte records 
terminated by an end-of-file. To the extent possible, the 
tape is treated like any other file (although this is often 
very inefficient). Although is is possible to read or write 
one byte at a time, writing in very small units is 
inadvisable because it tends to create enormous record gaps. 

The file mt0 is useful when it is desirable to access the 
tape in a way compatible with ordinary files. Tfhen dealing 
with foreign tapes, or when reading or writing long records, 
the "raw” interface is appropriate. The maximum buffer size 
for the raw interface is 64k-l bytes. The "raw" interface 
can be accessed via the files rmt0 and rmt4, where rmt0 is 
rewound after closing and rmt4 is not. Several ioctl 
operations are available on raw magnetic tape. The 
following definitions are from <sys/mtio.h>s 


/* 



fifndef _IOCTL_ 
#include <sys/ioctl.h> 
#endif 


/* structure for MTIOCTOP - mag tape op command */ 


struct ratop { 

short mt_op; /* operations defined below */ 

short mt_count; /* how many of them */ 


/* operations; */ 


#define 

MTWEOF 

0 

/* 

#define 

MTFSF 

1 

/* 

#define 

MTBSF 

2 

/* 

♦define 

MTPSR 

3 

/* 

♦define 

MTBSR 

4 

/* 

♦define 

riTREW 

5 

/* 

♦define 

MTOFFL 

6 

/* 

♦define 

IITNOP 

7 


write an end-of-file record */ 
forward space file */ 
backward space file */ 
forward space record */ 
backward space record */ 
rewind */ 

rewind and put the drive offline 
/* nop */ 


*/ 
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tdefine MTERASE 8 


/* erase to end of tape */ 


/* structure for MTIOCGET - mag tape get status command */ 


struct mtget { 

short mt_dsreg; /* drive status r 

short rat_erreg; /* error register 

short mt_resid; /* residual count 

/* the following two are not yet implement 

short mt_fileno; /* file numb 

short mt blkno; /* block number o 


jegister */ 

*/ 

V 

ed */ 
er of current pos 
f current positio 


}; 


/* the bits in these registers are grossl:y[ 
/* should be defined here but aren't */ 


Each read or write call reads or writes th 
the tape. For writes, the record length 
buffer given. For a read, the number of bj; 
lesser of the buffer size and the record 
io, a seek is ignored. 


e next record oln 
is the size of the 
ytes read is the 
ize. For raw tap 


FILES 


/dev/mtC0» 4] 
/dev/rmtCU,4] 


block devices 
raw devices 


BUGS 


An error should be returned if the record 
than the read buffer size. 


TM(4) 


ition */ 
*/ 


h 


device dependent 


size is greate 
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NAME 

tty - general terminal interface 
DESCRIPTION 

This section describes both a particular special file, and 
the general nature of the terminal interface. 

The file / dev / tty is, in each process, a synonym for the 
control terminal associated with that process. It is useful 
for programs that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can 
also be used for programs that demand a file name for 
output, when typed output is desired and it is tiresome to 
find out which terminal is currently in use. 

As for terminals in general: all of the low-speed 
asynchronous communications ports use the same general 
interface, no matter what hardware is involved. The 
remainder of this section discusses the common features of 
the interface. 

lihen a terminal file is opened, it causes the process to 
wait until a connection is established. In practice user's 
programs seldom open these files; they are opened by init 
and become a user's input and output file. The very first 
terminal file open in a process becomes the control terminal 
for that process. The control terminal plays a special role 
in handling quit or interrupt signals, as discussed below. 
The control terminal is inherited by a child process during 
a fork , even if the control terminal is closed. The set of 
processes that thus share a control terminal is called a 
process group ; all members of a process group receive 
certain signals together, see DEL below and kill (2). 

A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only lost 
when the system's character input buffers become completely 
choked, which is rare, or when the user has accumulated the 
maxiraiam allowed number of input characters that have not yet 
been read by some program. Currently this limit is 256 
characters. ’I'Jhen the input limit is reached all the saved 
characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. 

This means that a program attempting to read will be 
suspended until an entire line has been typed. Also, no 
matter how many characters are requested in the read call, 
at most one line will be returned. It is not however 
necessary to read a whole line at once; any number of 
characters may be requested in a read, even one, without 
losing information. There are special modes, discussed 
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below, that iDermit the program to read eac|li character as 
typed without waiting for a full line. 


normally done, 
ast character 


During input, erase and kill processing is 
By default, the character '#' erases the 1 
typed, except that it will not erase beyond the beginning o 
a line or an EOT. By default, the character kills the 

entire line up to the point where it was typed, but not 
beyond an EOT. Both these characters operjate on a keystrok 
basis independently of any backspacing or 
have been done. Either or '#' may be 

by preceding it by the erase or kill 

but the '\* disappears. These two charact! 
to others. 


tabbing that may 
entered literally! 
character remains! 
|ers may be change 


When desired, all upper-case letters are m 
corresponding lower-case letter. The uppe 
be generated by preceding it by '\'. In a 
following escape sequences can be generat^ 
accepted on input: 


apped into the 
r-case letter may! 
Iddition, the 
Id on output and 


for 


} 


use 

\‘ 

\i 

\( 

\) 


Certain ASCII control characters have spec 
These characters are not passed to a readi 
in raw mode where they lose their special 
it is possible to change these characters 
see below. 


EOT 


(Control-D) may be used to generate 
a terminal. When an EOT is received, 
characters waiting to be read are immi 
the program, without waiting for a ne| 
EOT is discarded. Thus if there are 
waiting, which is to say the EOT occij 
beginning of a line, zero characters 
back, and this is the standard end-o^ 


DEL 


(Rubout) is not passed to a progreun 
interrupt signal which is sent to all 
the associated control terminal. No 
process is forced to terminate, but 
made either to ignore the signal or 
to an agreed-upon location. See sigrj 


FS 


(Control-\ or control-shift-L) genera 
signal. Its treatment is identical 


ial meaning, 
ng program except] 
character. Also, 
from the default; 


,n end of file froha 
all the 

ediately passed tb 
iw-line, and the 
no characters 
rred at the 
will be passed 
-file indication. 


ut generates an 
processes with 
r|mally each such 
arrangements may 
o receive a trap 
al(2). 


tes the quit 
o the interrupt 
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signal except that unless a receiving process has made 
other arrangements it will not only be terminated but a 
core image file will be generated. 

DC3 (Control-S) delays all printing on the terminal until 
something is typed in. 

DCl (Control-Q) restarts printing after DC3 without 
generating any input to a program. 

When the carrier signal from the dataset drops (usually 
because the user has hung up his terminal) a hangup signal 
is sent to all processes with the terminal as control 
terminal. Unless other arrangements have been made, this 
signal causes the processes to terminate. If the hangup 
signal is ignored, any read returns with an end-of-file 
indication. Thus programs that read a terminal and test for 
end-of-file on their input can terminate appropriately when 
hung up on. 

I'Vhen one or more characters are written, they are actually 
transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are 
echoed by putting them in the output queue as they arrive. 
When a process produces characters more rapidly than they 
can be typed, it will be suspended when its output queue 
exceeds some limit. When the queue has drained down to some 
threshold the program is resumed. Even parity is always 
generated on output. The EOT character is not transmitted 
(except in raw mode) to prevent terrainals that respond to it 
from hanging up. 

Several ioctl (2) calls apply to terminals. Most of them use 
the following structure, defined in < 3gtty .h>; 

struct sgttyb { 

char sg_ispeed; 
char sg_ospeed; 
char sg_erase; 
char sg_kill; 
int sg flags; 

}; 


The sg ispeed and sg ospeed fields describe the input and 
output speeds of the device according to the following 
table, which corresponds to the DEC DH-11 interface. If 
other hardware is used, impossible speed changes are 
ignored. Symbolic values in the table are as defined in 
< sgtty .h>. 

B0 0 (hang up dataphone) 

B50 1 50 baud 
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B75 

2 

B110 

3 

B134 

4 

B150 

5 

B200 

6 

B300 

7 

B600 

8 

B1200 

9 

B1800 

10 

32400 

11 

B4800 

12 

B9600 

13 

EXTA 

14 

EXTB 

15 


7 5 baud 
110 baud 
134.5 baud 
150 baud 
200 baud 
300 baud 
600 baud 
1200 baud 
1800 baud 
2400 baud 
4800 baud 
9600 baud 
External A 
External B 


In the current configuration, only 110, 150, 300 and 1200 
baud are really supported on dial-up line.?* Code conversion 
and line control required for IBM 2741*s jl34.5 baud) must 
be implemented by the user's program. The half-duplex line 
discipline required for the 202 dataset (1200 baud) is not 
supplied; full-duplex 212 datasets work fine. 

The sg erase and sg kill fields of the argument structure 
specify the erase and kill characters respectively. 

(Defaults are # and @.) 


The sg flags field of the argument structu 
several bits that determine the system's 
terminal: 


re contains 
treatment of the 


ALLDELAY 

0177400 

BSDELAY 

0100000 

3S0 

0 

BSl 

0100000 

VTDELAY 

0040000 

FF0 

0 

FFl 

0100000 

CRDELAY 

0030000 

CR0 

0 

CRl 

0010000 

CR2 

0020000 

CR3 

0030000 

TBDELAY 

0006000 

TAB0 

0 

TABl 

0001000 

TAB 2 

0004000 

XTABS 

0006000 

NLDELAY 

0001400 

NL0 

0 

NLl 

0000400 

NL2 

0001000 

NL3 

0001400 


Delay algorithm selectioiji 

Select backspace delays (not implemented) 


Select form-feed and vertical-tab delays 


Select carriage-return delays: 


Select tab delays: 


Select new-line delays; 
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EVENP 

0000200 

ODDP 

0000100 

RAW 

0000040 

CRMOD 

0000020 

ECHO 

0000010 

LCASE 

0000004 

CBREAK 

0000002 

TANDEM 

0000001 


Even parity allowed on input (most terminals) 

Odd parity allowed on input 

Raw mode: wake up on all characters, 8-bit interface 
Map CR into LF; echo LF or CR as CR-LF 
Echo (full duplex) 

Map upper case to lower on input 
Return each character as soon as typed 
Automatic flow control 


The delay bits specify how long transmission stops to allow 
for mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of 0 indicates 
no delay. 

Backspace delays are currently ignored but might be used for 
Terrainet 300's. 

If a form-feed/vertical tab delay is specified, it lasts for 
about 2 seconds. 


Carriage-return delay type 1 lasts about .08 seconds and is 
suitable for the Terminet 300. Delay type 2 lasts about .16 
seconds and is suitable for the VT05 and the TI 700. Delay 
type 3 is unimplamented and is 0. 

New-line delay type 1 is dependent on the current column and 
is tuned for Teletype model 37's. Type 2 is useful for the 
VT05 and is about .10 seconds. Type 3 is unirapleraented and 
is 0. ■ 


Tab delay type 1 is dependent on the amount of movement and 
is tuned to the Teletype model 37. Type 3, called XTABS, is 
not a delay at all but causes tabs to be replaced by the 
appropriate number of spaces on output. 

Characters with the wrong parity, as determined by bits 200 
and 100, are ignored. 

In raw mode, every character is passed immediately to the 
program without waiting until a full line has been typed. 

No erase or kill processing is done; the end-of-file 
indicator (SOT), the interrupt character (DEL) and the quit 
character (FS) are not treated specially. There are no 
delays and no echoing, and no replacement of one character 
for another; characters are a full 8 bits for both input and 
output (parity is up to the program). 

Mode 020 causes input carriage returns to be turned into 
new-lines; input of either CR or LF causes LF-CR both to be 
echoed (for terminals with a new-line function). 

CBREAK is a sort of half-cooked (rare?) mode. Programs can 
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read each character as soon as typed, instead of waiting for 
a full line, but quit and interrupt work, and output delays, 
case-translation, CRMOD, XTABS, ECHO, and parity work 
normally. On the other hand there is no erase or kill, and 
no special treatment of \ or EOT. 

TANDEM mode causes the system to produce a, stop character 
(default DC3) whenever the input queue is in danger of 
overflowing, and a start character (default DCl) when the 
input queue has drained sufficiently. It is useful for flo 
control when the 'terminal* is actually another machine tha 
obeys the conventions. 

Several ioctl calls have the form: 

tinclude <sgtty.h> 

ioctl(fildes, code, arg) 
struct sgttyb *arg; 

The applicable codes are: 

TIOCGETP 

Fetch the parameters associated with the terminal, and 
store in the pointed-to structure. 


TIOCSETP 

Set the parameters according to the j;»ointed-to 
structure. The interface delays unti.l output is 
quiescent, then throws away any unrecid characters, 
before changing the modes. 

TIOCSETN 

Set the parameters but do not delay or flush input. 
Switching out of RAW or CBREAK mode may cause some 
garbage input. 

With the following codes the arg is ignored. 


TIOCEXCL 

Set ''exclusive-use*' mode: no further opens are 
permitted until the file has been closed. 


TIOCNXCL 

Turn off 


exclusive-use* * mode. 


TIOCHPCL 

When the file is closed for the last time, hang up th€ 
terminal. This is useful when the line is associated 
with an ACU used to place outgoing ceills. 

TIOCPLUSH 
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All characters waiting in input or output queues are 
flushed. 

The following codes affect characters that are special to 
the terminal interface. The argument is a i^ointer to the 
following structure, defined in < sgtty .h>; 

struct tchars I 

char t_intrc; 
char t_quitc; 
char t_startc; 
char t_stopc; 
char t_eofc; 
char t brkc; 

}; 

The default values for these characters are DEL, FS, DCl, 
DC3, EOT, and -1. A character value of -1 eliminates the 
effect of that character. The t brkc character, by default 
-1, acts like a new-line in that it terminates a 'line,* is 
echoed, and is passed to the program. The 'stop* and 
'start* characters may be the same, to produce a toggle 
effect. It is probably counterproductive to make other 
special characters (including erase an kill) identical. 

The calls are: 

TIOCSETC 

Change the various special characters to those given in 
the structure. 

TIOCSETP 

Set the special characters to those given in the 
structure. 


/* interrupt */ 

/* quit */ 

/* start output */ 

/* stop output */ 

/* end-of-file */ 

/* input delimiter (like nl) */ 


FILES 

/dev/tty 
/dev/tty* 

/dev/console 

SEE ALSO 

getty(8), stty (1), signal(2), ioctl(2) 


BUGS 

Half-duplex terminals are not supported. 

The terminal handler has clearly entered the race for ever- 
greater complexity and generality. It's still not complex 
and general enough for TENEX fans. 
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NAME 

a.out - assembler and link editor output 
SYNOPSIS 

#include <a.out.h> 


DESCRIPTION 

A. out is the output file of the assembler as(l) and the link 
editor 1^(1). Both programs make a. out executable if there 
were no errors and no unresolved external references. 

Layout information as given in the include file is: 


/* 

* Header prepended to each a.out file. 

*l 


struct ( 

axec 1 






long 

a_magic; 

/* 

magic number */ 



long 

a_text 7 

/* 

size of text segment */ 



long 

a_data 7 

/* 

size of initialized data 

*/ 


long 

a_bss 7 

/* 

size of uninitialized data */ 


long 

a_syms 7 

/* 

size of symbol table */ 



long 

a_trsize7 

/* 

size of text relocation 

*/ 


long 

a_drsize7 

/* 

size of data relocation 

*/ 

}; 

long 

a_entry7 

/* 

entry point */ 


tdefine 

OMAGIC 

0407 

/* 

old impure format */ 


#define 

NMAGIC 

0410 

/* 

read-only text */ 


#define 

ZMAGIC 

0413 

/* 

demand load format */ 



/* 

* 

* 

* 


Macros which take exec structures as arguments and tell whether 
the file has a reasonable magic number or offsets to text 1 symbols 1s 


#define N_BADMAG(x) (((x).a_magic)1=0MAGIC && ((x).a_magic)1=NMAGI 


#define N_TXTOFF(x) 
tdefine N_SYMOFF(x) 
#define N STROFF(x) 


((x) .a_magic==Zi'lAGIC ? 1024 : sizeof {stru 
(N_TXTOFF(x) + (x).a_text+(x).a_data + (x) 
( N_SYMOFF(X) + (X).a_syms) 


/* 

* Format of a relocation datum. 

*/ 

struct relocation_info { 

long r_address; /* address which is relocated */ 
unsigned short r_symbolnum,/* local symbol ordinal */ 

r_jpcrel:l, /* was relocated pc relative already */ 
r_length:2,/* 0=byte, l=word, 2=long */ 
r_extern:1,/* does not include value of syra reference 
:47 /* nothing, yet */ 

}; 
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/* , 

* Format of a symbol table entry; this file is included by <a.o|ut.h> 

* and should be used if you aren't interested the a.out header 

* or relocation information. 

*! 

struct nlist { 
union { 

char *n_name;/* for use 

long n_strx; /* index intfo file string tat)le */ 

} n_un; 

unsigned char n_type 7 /* type flag, i.e. 
char n_other; /* unused */ 

short n_desc; /* see <stab.h> */ 

# ifndef pdpll 

unsigned long n_value;/* value of this 

# else 

long n_value; 

# endif 

}; 

tdefine n hash n desc /* used internally 


when in-core */ 

I file string t< 

N TEXT etc; see 




* Simple values for n type. 

* / 


/ 

#define 

N UNDP 

0X0 

/* 

undefined */ 



tdefine 

lJ ABS 

0X2 

/* 

absolute */ 



#define 

N TEXT 

0x4 

/* 

text */ 



#define 

N DATA 

0x6 

/* 

data */ 



#define 

I.J BSS 

0x8 

/* 

bss */ 



#define 

n COMM 

0x12 

/* 

common (internal 

. to 

Id) */ 

#define 

N_FN 

0xle 

/* 

file name symbol 

. */ 


#define 

N EXT 

01 

/* 

external bit, ot 

■'ed 

in */ 

#define 

N TYPE 

0xle 

/* 

mask for all the 

‘ type bits 


bits set, a SDB entry 


/* 

* Sdb entries have some of the N_STAB bits set 

* These are given in <stab.h> 

*/ 

#define N_STAB 0xe0 /* if any of these 

/* 

* Format for namelist values. 

*/ 

#define NJFORMAT "%081x’' 

The file has four sections: a header, the program and data 
text, relocation information, and a symbol table (in that 
order). The last two may be empty if the progi’am was loaded 
with the '-s' option of ^ or if the symbols and relocation 
have been removed by strip (l). 
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In the header the sizes of each section are given in bytes, 
but are even. T>ie size of the header is not included in any 
of the other sizes. 

When an a. out file is loaded into core for execution, three 
logical segments are set up; the text segment, the data 
segment (with uninitialized data, which starts off as all 0, 
following initialized), and a stack. The text segment 
begins at 0 in the core image; the header is not loaded. If 
the magic number in the header is 0407(8), it indicates that 
the text segment is not to be write-protected and shared, so 
the data segment is immediately contiguous with the text 
segment. If the magic number is 0410, the data segment 
begins at the first 0 mod 8K byte boundary following the 
text segment, and the text segment is not writable by the 
program; if other processes are executing the same file, 
they will share the text segment. If the magic number is 
411, the text segment is again pure, write-protected, and 
shared, and moreover instruction and data space are 
separated; the text and data segment both begin at location 
0. If the magic number is 0405, the text segment is 
overlaid on an existing (0411 or 0405) text segment and the 
existing data segment is preserved. 

The stack will occupy the highest possible locations in the 
core image; from 0177776(8) and growing downwards. The 
stack is automatically extended as required. The data 
segment is only extended as requested by brk(2). 

Tlae start of the text segment in the file is 020(8); the 
start of the data segment is 020+S9t3 (the size of the text) 
the start of the relocation information is 020-»-S9t3+S9d8; the 
start of the symbol table is 020+2(S9t8+S9d8) if the relocation 
information is present, 020+S9t8+S9d8 if not. 

The layout of a symbol table entry and the principal flag 
values that distinguish symbol types are given in the 
include file. Other flag values may occur if an assembly 
language program defines machine instructions. 

If a symbol's type is undefined external, and the value 
field is non-zero, the symbol is interpreted by the loader 
as the name of a common region whose size is indicated by 
the value of the symbol. 

The value of a word in the text or data portions v/hich is 
not a reference to an undefined external symbol is exactly 
that value which will appear in core when the file is 
executed. If a word in the text or data portion involves a 
reference to an undefined external symbol, as indicated by 
the relocation information for that word, then the value of 
the word as stored in the file is an offset from the 
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associated external symbol. Ifhen the fi 
the link editor and the external symbol 
value of the symbol will be added into t 

If relocation information is present, it 
per word of program text or initialized 
relocation information if the 'relocatiol 
flag in the header is on. 


Bits 3-1 of a relocation word indicate t 
to by the text or data word associated 
word: 


000 absolute number 
002 reference to text segment 

004 reference to initialized data 

006 reference to uninitialized data (bs^) 

010 reference to undefined external symiaol 


A. OUT 


(5) 


le is processed bly 
becomes defined, the 
jhe word in the file. 

amounts to one ward 
jdata. There is np 
n info stripped' 


he segment referrp 
ith the relocatio 


Bit 0 of the relocation word indicates, 
reference is relative to the pc (e.g. 'c 
the reference is to the actual symbol (e 


if 1, that the 
Ir x'); if 0, tha^ 
.g., 'clr *$x’). 


The remainder of the relocation word (bits 15-4) contains 
symbol number in the case of external references, and is 
unused otherwise. The first symbol is numbered 0, the 
second 1, etc. 

SEE ALSO 

as(1), ld(1), nm(1) 
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NAME 

acct - execution accounting file 

SYNOPSIS 

#include <sys/acct.h> 

DESCRIPTION 

Acct(2) causes entries to be made into an accounting file 
for each process that terminates. The accounting file is a 
sequence of entries whose layout, as defined by the include 
file is: 

/* 

(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1983. ALL 
RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORPORATED. 
RESTRICTED RIGHTS - USE, DUPLICATION, OR DISCLOSURE IS SUBJECT 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE AGREEMENT AlS 
ASSOCIATED DOCUMENTATION. 

*/ 

#ifdef SCCSID 

static char id_acctC] = "@{#)acct.hi.2 (Texas Instruments) 83/06/27"; 
#endif 

#ifndef SCCSID 
/* 

* Accounting structures 
*/ 

typedef unsigned short comp_t;/* "floating pt"; 3 bits base 8 exp, 13 
struct acct 

( 

char ac_coramCl0]; /* Accounting command name */ 

comp_t ac_utime 7 /* Accounting user time */ 

comp_t ac_stime; /* Accounting system time */ 

comp_t ac_etiine; /* Accounting elapsed time */ 

time_t ac_btime 7 /* Beginning time */ 

short ac_uid; /* Accounting user ID */ 

short ac_gid7 /* Accounting group ID */ 

short ac_mem; /* average memory usage */ 

comp_t ac_io; /* number of disk lO blocks */ 

dev_t ac_tty 7 /* control typewriter */ 

char ac_flag; /* Accounting flag */ 

} ; 

extern struct acct acctbuf; 

extern struct inode *acctp 7 /* inode of accounting file */ 

tdefine AFORK 01 /* has executed fork, but no exec */ 

#define ASU 02 /* used super-user privileges */ 
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#endif 

If the process does an exec (2), the first 10 characters oi: 
the filename appear in ac comm . The accounting flag contains 
bits indicating whether exec (2) was ever accomplished, ancl 
whether the process ever had sui^er-user privileges. 

SEE ALSO 

acct(2), sa{l) 


5) 
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NAME 

ar - archive (library) file format 

SYNOPSIS 

#include <ar.h> 

DESCRIPTION 

The archive command ^ is used to combine several files into 
one. Archives are used mainly as libraries to be searched 
by the link-editor Id . 

A file produced by ^ has a magic number at the start, 
followed by the constituent files, each preceded by a file 
header. The magic number and header layout as described in 
the include file are: 

#define ARMAG '*i<arch>0 

idefine SARMAG8 

#define ARFMAG"'0 

struct ar_hdr { 

char ar_nameCl6]7 
char ar_dateCl2]; 
char ar_uid[6]; 
char ar_gidC6]; 
char ar_modeC8]; 
char ar_sizeCl0]; 
char ar_fmagC2]; 


The name is a null-terminated string; the date is in the 
form of time (2); the user ID and group ID are numbers; the 
mode is a bit pattern per chmod (2); the size is counted in 
bytes. 

Each file begins on a \7ord boundary; a null byte is inserted 
between files if necessary. Nevertheless the size given 
reflects the actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive 
file. 

SEE ALSO 

ar(l), ld(l), nm(l) 


BUGS 

Coding user and group IDs as characters is a botch. 
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NAME 


core - format of core image file 


DESCRIPTION 

UNIX writes out a core image of a termin 
any of various errors occur. See signal 


reasons; the most common are memory viola 
instructions, bus errors, and user-gener 
The core image is called 'core' and is w 
process's working directory (provided it 
access controls apply). 


ar 


The first 1024 bytes of the core image 
system’s per-user data for the process, 
registers as they were at the time of th^ 
system listings for the format of this a 
represents the actual contents of the us 
the core image was written. If the text 
protected and shared, it is not dumped; 
address space is dumped. 


CORE(5) 


^ted process when 
2) for the list c|)f 
tions, illegal 
4ted quit signals 
i’itten in the 
can be; normal 


e a copy of the 
including the 
fault; see the 
tea. The remainder 
4r's core area wh^n 
segment is write 
otherwise the entire 


In general the debugger adb (1) is sufficient to deal with 
core images. 

SEE ALSO 

adb(l), signal(2) 


Page 1 


(printed 8/25/83) 




DIR(5) 


Nu Machine UNIX Progrcunraer' s Manual 


DIR(5) 


NAME 

dir - format of directories 


SYNOPSIS 

#include <sys/dir.h> 


DESCRIPTION 

A directory behaves exactly like an ordinary file, save that 
no user may write into a directory. The fact that a file is 
a directory is indicated by a bit in the flag word of its 
i-node entry see, filsys (5). The structure of a directory 
entry as given in the include file is; 


/* 

(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1983. ALL 
RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORPORATED. 
RESTRICTED RIGHTS - USE, DUPLICATION, OR DISCLOSURE IS SUBJECT 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE AGREEMENT AND 
ASSOCIATED DOCUMENTATION. 

*/ 

#ifdef SCCSID 

static char id_dirC] = "@(#)dir.hi.2 (Texas Instruments) 83/06/27"; 
#endif 

#ifndef SCCSID 

tifndef DIRSIZ 
fdefine DIRSIZ14 
#endif 

struct direct 

( 

ino_t d_ino; 

char d_nameCDIRSIZ]; 

} ; 

#endif 

3y convention, the first two entries in each directory are 
for . and .. . The first is an entry for the directory 
itself. The second is for the parent directory. The 
meaning of ..' is modified for the root directory of the 
master file system and for the root directories of removable 
file systems. In the first case, there is no parent, and in 
the second, the system does not permit off-device 
references. Therefore in both cases has the same 

meaning as '.'. 

SEE ALSO 

filsys(5) 
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NAME 


dump, ddate - incremental dump format 


SYNOPSIS 

#include <sys/types.h> 

#include <sys/ino.h> 

# include <dumprestor.h> 

DESCRIPTION 

Tapes used by dump and restor (1) contain^ 

a header record 
two groups of bit map records 
a group of records describing direc|: 
a group of records describing files 


The format of the header record and of t 
each description as given in the include 
is: 


;ie first record of 
file <dumprestorih> 


#define NTREC 
#define MLEN 
tdefine MSIZ 

#define TS_TAPE 
tdefine TS_INODE 
#define TS_BITS 
tdefine TS_ADDR 
tdefine TS_END 
tdefine TS_CLRI 
tdefine MAGIC 
tdefine CHECKSUM 
struct 
{ 

int 

int 

int 

int 

int 

t ime_t 
t ime_t 
daddr_t 
ino_t 
struct 
char 
} spcl; 

struct 

char 
char 
time t 


20/* this may need to cViange to 1 */ 
16 

4096 


1 
2 

3 

4 

5 

6 

(int)60011 
(int)84446 
spcl 

c_checksum;/* this needj 
c_type 7 
c_magic; 
c_volume; 
c_count; 
c_date; 
c_ddate; 
c_tapea; 
c_inumber; 
dinodec_dinode; 
c addrCBSIZE]? 


idates 

id_nameCl6]; 
id_incno 7 
id ddate; 
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}; 

NTREC is the number of 512 byte records in a physical tape 
block. MLEN is the number of bits in a bit map word. MSIZ 
is the number of bit map words. 

The TS entries are used in the c type field to indicate 
what sort of header this is. The types and their meanings 
are as follows: 

TS_TAPE Tape volume label 
TS_INODE 

A file or directory follows. Tlie c dinode field is 
a copy of the disk inode and contains bits telling 
what sort of file this is. 

TS_BITS A bit map follows. This bit map has a one bit for 
each inode that was dumped. 

TS_ADDR A subrecord of a file description. See c addr 
below. 

TS_END End of tape record. 

TS_CLRI A bit map follows. This bit map contains a zero bit 
for all inodes that were empty on the file system 
when dumped. 

MAGIC All header records have this number in c magic. 
CHECKSUM 

Header records checksum to this value. 

The fields of the header structure are as follows: 

G_type The type of the header. 

c_date The date the dump was taken. 

c_ddate The date the file system was dumped from. 

c_volume The current volume number of the dump. 

c_tapea The current number of this (512-byte) record. 

c_inumber 

The number of the inode being dumped if this is of 
type TS INODE . 

c_magic This contains the value riAGIC above, truncated as 
needed. 
c_checksum 

This contains whatever value is needed to make the 
record sum to CHECKSUM . 

c_dinode This is a copy of the inode as it appears on the 
file system; see filsys (5). 
c_couat The count of characters in c addr . 

c_addr An array of characters describing the blocks of the 
dumped file. A character is zero if the block 
associated with that character was not ^present on 
the file system, otherwise the character is non¬ 
zero. If the block was not present on the file 
system, no block was dumped; the block will be 
restored as a hole in the file. If there is not 
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sufficient space in this record 
the blocks in a file, TS ADDR r 
scattered through the file, eac 
where the last left off. 

Each volume except the last ends v/ith a 
end of file) . The last volume ends with! 
then the tapemark. 


DUMP{5) 


to describe all 
ecords will be 
:h one picking up 


bf 


[tapemark (read as an 
a TS END record and 


The structure idates describes an entry pf the file 
/ etc / ddate where dump history is kept, 
structure are; 


fields of the 


Id nam'. 


id_name The dumped filesystem is '/dev/_ 

id_incno The level number of the dump tabe; see dump (1) 
id_ddate The date of the incremental dump in system formaj; 
see types (5). 


FILES 

/etc/ddate 
SEE ALSO 

dump(l), dumpdir(l), restor(l), filsys(5 


), types(5) 
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NAME ■ 

environ - user environment 

SYNOPSIS 

extern char **environ; 

DESCRIPTION 

An array of strings called the 'environment* is made 
available by exec (2) when a process begins. By convention 
these strings have the form 'name=value'. The following 
names are used by various commands; 

PATH The sequence of directory prefixes that time , 

nice(l), etc., apply in searching for a file known by 
an incomplete path name. The prefixes are separated by 
Login (1) sets PATH=;/bin;/usr/bin. 

HOME A user’s login directory, set by login(1) from the 
password file passv/d (5 ). 

TERM The kind of terminal for which output is to be 

prepared. This information is used by commands, such 

plot (1), which may exploit special terminal 
capabilities. See term (7) for a list of terminal 
types. 

Further names may be placed in the environment by the export 
command and 'name=value' arguments in ^h(l), or by exec(2). ' 
It is unwise to conflict with certain Shell variables that 
are frequently exported by '.profile' files; MAIL, PSl, PS2, 
IFS. 

SEE ALSO 

exec(2), sh{l), term(7), login(l) 
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NAME 


filsys, flblk, ino - format of file sys 


tem volume 


SYNOPSIS 

#include <sys/types.h> 

♦include <sys/flbk.h> 

♦include <sys/filsys.h> 

♦include <sys/ino.h> 

DESCRIPTION 

Every file system storage volume has a 
certain vital information. Every such 
into a certain number of blocks. Block 
available to contain a bootstrap prograt 
other information. 

Block 1 is the super block . The layout 
defined by the include file < sys / filsys 


(C) COPYRIGHT, TEXAS INSTRUMENTS INCO 


FILSY 


P(5) 


common format for 
Ivolume is divided 
0 is unused and is 
to, pack label, or 


lof the super bloc)c as 
.h> is: 


RPORATED, 1983. 


7 


RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORP 
RESTRICTED RIGHTS - USE, DUPLICATION, OR DISCLOSURE IS 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE AGRE 
ASSOCIATED DOCUMENTATION. 


♦ifdef 3CCSID 

static char id_filsys[] = "@(♦)filsys.hi.2 ( 
♦endif 


Texas Instruments) 83/06/27"; 


♦ifndef SCCSID 


h 


filsys.h 4.3 


81/03/03*/ 


/* 

* Structure of 
*/ 

struct filsys 

unsigned 

daddr_t 

short 

daddr_t 

short 

ino_t 

char 

char 

char 

char 

time_t 

daddr t 


the super-block 


short s_isize; 

s_fsize; 

s_nfree; 

s_freeCNICFREE]; 
s_ninode; 
s_inodeCNICINOD]; 
s_flock; 
s_ilock 7 
s_f mod; 
s_ronly; 
s_time; 
s tfree; 


/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 


free i 
lock du 
lock du 
super b 
mounted 


ALL 

ORATED. 

SUBJECT 
BMENT An 


size in blocks of i-list */ 
size in blocks of entire volume]*/ 
number of addresses in sj_free */ 
free block list */ 
number of i-nodes in s_ii|iode */ 

■node list */ 

iring free list manipulation */ 
iring i-list manipi 
)lock modified flag 
read-only flag *, 

/* last su^er block update j/ 

/* total ftee blocks*/ 
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ino_t s_t inode ; 

short s_dinfo[2]; 

#define s_m 

#define s_n 

char s_fsmntCl 2]7 

/* end not maintained */ 
ino_t s_lasti; 

ino t s nbehind; 

}; 

#ifdef KERNEL 
struct filsys *getfs()j 
#endif 

#endif 

S isize is the address of the first block after the i-list, 
which starts just after the super-block, in block 2. Thus 
is i-list is s isize -2 blocks long. S fsize is the address 
of the first block not potentially available for allocation 
to a file. These numbers are used by the system to check 
for bad block addresses; if an 'impossible' block address is 
allocated from the free list or is freed, a diagnostic is 
written on the on-line console. Moreover, the free array is 
cleared, so as to prevent further allocation from a 
presumably corrupted free list. 

The free list for each volume is maintained as follows. Tlie 
s free array contains, in s free [l], ... , 
s free [ s nfree -1], up to NICFREE free block numbers. 

NICFREE is a configuration constant. 3 free CU] is the block 
address of the head of a chain of blocks constituting the 
free list. The layout of each block of the free chain as 
defined in the include file < sys / fblk .h> is; 

/* 

(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1983. ALL 
RIGHTS RESERVED. PROPERTY OP TEXAS INSTRUMENTS INCORPORATED. 
RESTRICTED RIGHTS - USE, DUPLICATION, OR DISCLOSURE IS SUBJECT 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE AGREEMENT AND 
ASSOCIATED DOCUMENTATION. 

*/ 

#ifdef seesID 

static char id fblkC] = "@(#)fblk.hl.2 (Texas Instruments) 83/06/27"; 
#endif 

#ifndef SCCSID 

struct fblk 

{ 

short df nfree; 


/* total free inodes */ 

/* interleave stuff */ 

s_dinfoC0] 

s_dinfoCl] 

/* ordinary file mounted on */ 

/* start place for circular search */ 
/* est # free inodes before s lasti */ 
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}; 

#endif 


daddr t df free[NICFREE]; 


The fields df nfree and df free in a fre 


exactly like s nfree and s free in the 
allocate a block: decrement s nfree , an^ 
number is s free [ s nfree ]. If the new b 
there are no blocks left, so give an eri: 
became 0, read the new block into s nfr4 


e block are used 
super block. To 
the new block 
ock address is 
or. If s nfree 
e and s free. To 


free a block, check if s nfree is NICFRE 
s nfree and the s free array into it, w 
s nfree to 0. In any event set s free C 
block's address and increment s nfree. 


SE; if so, copy 
^ite it out, and 
nfree] to the f: 


S ninode is the number of free i-numbers in the s inode 
array. To allocate an i-node; if s nin 
0, decrement it and return s inodets niiliode]. If it was Gjl 


of 


read the i-list and place the numbers 
to NICINOD) into the s inode array, the^ 
an i-node, provided s ninode is less ths 
its number into s inode[s ninode] and i 


all free inodes [(up 
try again. To free 
n NICINODE, plac^ 
ncrement s ninode 


s ninode is already NICINODE, don't botlji 
freed i-node into any table. This list 
to speed up the allocation process; the 
whether the inode is really free or not 
inode itself. 


S flock and s ilock are flags maintainec^ 
the file system while it is mounted and 
are immaterial. The value of s fraod on 


immaterial; it is used as a flag to indi 
super-block has changed and should be c 
during the next periodic update of file 
S ronly is a write-protection indicator 
also immaterial. 


S time is the last time the super-block 


of 


was changed. During a reboot, s time 
the root file system is used to set the 
time. 


The fields s tfree , s tlnode , s fname and s fpack are noti 
currently maintained. 


fo 


I-nurabers begin at 1, and the storage 
block 2. I-nodes are 64 bytes long, so 
block. I-node 2 is reserved for the ro 
file system, but no other i-number has 
Each i-node represents one file. The 
given in the include file < sys / ino .h> is 
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er to enter the 
of i-nodes is onl 
information as to 
is maintained in 


set 

eed 


n 


in the core copy 
their values on q 
disk is likewise 
cate that the 
opied to the disk 
system informatitin. 
its disk value Is 


of the file system 
the super-block for 
system's idea of the 


r i-nodes begins 
8 of them fit in 
ot directory of tl. 
built-in meaninc 
rraat of an i-nodei 


f<^ 
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/* 

(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPORATED, 1983. ALL 
RIGHTS RESERVED. PROPERTY OF TEXAS INSTRUMENTS INCORPORATED. 
RESTRICTED RIGHTS - USE, DUPLICATION, OR DISCLOSURE IS SUBJECl 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM LICENSE AGREEMENT AC^; 
ASSOCIATED DOCUMENTATION. 

*/ 

#ifdef SCCSID 

static char id_inoC] = "@(#)ino.hi.2 (Texas Instruments) 83/06/27"; 
#endif 

#ifndef SCCSID 
/* 

* Inode structure as it appears on 

* a disk block. 

*/ 

struct dinode 

{ 

unsigned short di_mode; /* mode and tyoe of file */ 

short di_nlink; /* number of links to file */ 

short di_uid; /* owner's user id */ 

short di_gid; /* owner's group id */ 

off_t di_size; /* number of bytes in file */ 

char di_addrC403; /* disk block addresses */ 

time_t di_atime; /* time last accessed */ 

time_t dijtntime; /* time last modified */ 

time_t di_ctime; /* time created */ 


tendif 

Pi mode tells the kind of file; it is encoded identically to 
i’he st mode field of stat(2) . Di nlink is the number of 
directory entries TXinksT that refer to this i-node. Di uid 
and di gid^ are the owner's user and group IDs. Size is the“ 
number of bytes in the file. Di atime and di mtiine are the 
times of last access and modification of the file contents 
(read, write or create) (see times (2)); Di ctiine records the 
time of last modification to the inode or to the file, and 
is used to determine whether it should be dumped. 

Special files are recognized by their modes and not by i- 
nuraber. A block-type special file is one which can 
potentially be mounted as a file system; a character—type 
special file cannot, though it is not necessarily 
character—oriented. For special files, the di addr field is 
occupied by the device code (see types (5)). Th^^device 
codes of block and character special files overlap. 

Disk addresses of plain files and directories are kept in 
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the array di addr packed into 3 bytes e 
addresses specify device blocks directl 
addresses are singly, doubly, and tripl^ 
to blocks of 128 block pointers. Point 
blocks have the type daddr t (see types 


For block b in a file to exist, it is not necessary that all 
blocks less than b exist. A. zero block number either in the 
address words of the i-node or in an indirect block 
indicates that the corresponding block has never been 
allocated. Such a missing block reads as if it containec^ 
all zero words. 


FILSYS(5) 


^ch. The first 1?) 
The last 3 
indirect and point 
^rs in indirect 
(5)). 


SEE ALSO 

icheck(l), dcheck(l), dir(5), mount(l). 


stat(2), types(5 
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NAME 

group - group file 
DESCRIPTION 

Group contains for each group the following information; 

group name 
encrypted password 
numerical group ID 

a comma separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; 
Each group is separated from the next by a new-line. If the 
password field is null/ no password is demanded. 

This file resides in directory /etc. Because of the 
encrypted passwords, it can and does have general read 
permission and can be used, for example, to map numerical 
group id's to names. 


PILES 

/etc/group 
SEE ALSO 

newgrp(l), crypt{3), passwd(l), passwd(5) 
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NAME 


mtab “ mounted file system table 


DESCRIPTION 

Mtab resides in directory / etc and conta|. 
devices mounted by the mount command* U, 
entries. 

3 ^ 


Each entry is 64 bytes long; the first 
padded name of the place where the sped 
the second 32 are the null-padded name o 
The special file has all its directories 
is» everything through the last /' is t 


MTAB( 


ns a table of 
ikount removes 


are the null- 
kl file is mountei^ 

[f the special fil 
stripped away; tTliat 
hrown away. 


look at it. It 


This table is present only so people can , ^ • 

does not matter to mount if there are duplicated entries 

to amount if a name cannot be found. 


hor 


5) 


FILES 

/etc/mtab 

SEE ALSO 

mount(1) 
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NAME 

passv/d - password file 
DESCRIPTION 

Passwd contains for each user the following information; 

name (login name, contains no upper case) 
encrypted password 
numerical user ID 
numerical group ID 

GCOS job number, box number, optional GCOS user-id 
initial working directory 
program to use as Shell 

This is an ASCII file. Each field within each user's entry 
is separated from the next by a colon. The GCOS field is 
used only when communicating with that system, and in other 
installations can contain any desired information. Each 
user is separated from the next by a new-line. If the 
password field is null, no password is demanded; if the 
Shell field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the 
encrypted passwords, it can and does have general read 
permission and can be used, for example,, to map numerical 
user id's to names. 


FILES 

/etc/passwd 
SEE ALSO 

getpwentO), login(l), crypt(3), passwd(l), group(5) 
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NAME 

plot - graphics interface 
DESCRIPTION 

Files of this format are produced by routines described ;.n 
plot (3 ), and are interpreted for various devices by commands 
described in plot (1). A graphics file is a stream of 
plotting instructions. Each instruction consists of an 
ASCII letter usually followed by bytes of binary 
information. The instructions are executed in order. A 
point is designated by four bytes representing the x and y 
values; each value is a signed integer. The last designcited 
point in an 1, m, n, or p instruction b«Jcomes the 'current 
point' for the next instruction. 

Each of the following descriptions begins with the name of 
the corresponding routine in plot (3). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point 
given by the next four bytes. See p].ot(1). 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point giv<jn by the next four 
bytes to the point given by the following four bytes. 

t label: Place the following ASCII stri.ng so that its first 
character falls on the current point.. The string is 
terminated by a newline. 

a arc; The first four bytes give the center, the next fcur 
give the starting point, and the last: four give the erd 
point of a circular arc. The least significant 
coordinate of the end point is used only to determine the 
quadrant. The arc is drawn counter-clockwise. 

c circle; The first four bytes give thei center of the 
circle, the next two the radius. 

e erase; Start another frame of output. 

f linemod: Take the following string, vp to a newline, as 
the style for drawing further lines. The styles are 
'dotted, ' 'solid, ' 'longdashed, ' 'shcirtdashed, * and 
'dotdashed.' Effective only in plot ^ .014 and plot ver . 

s space; The next four bytes give the lower left corner of 
the plotting area; the following four give the upper 
right corner. The plot will be magnified or reduced to 
fit the device as closely as possible. 
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settings that exactly fill the plotting area with 
unity scaling appear below for devices supported by the 
filters of plot (l). The upper limit is just outside the 
plotting area. In every case the plotting area is taken 
to be square; points outside may be displayable on 
devices whose face isn't square. 


4014 

space(0. 

0, 

3120, 

3120); 

ver 

space(0, 

0, 

2048, 

2048); 

300, 

300s space(0, 

0. 

4096, 

4096); 

450 

space(0, 

0, 

4096, 

4096); 


SEE ALSO 

plot(l), plot(3), graph(l) 
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NAME 

termcap - terminal capability data base 

SYNOPSIS 

/etc/termcap 

DESCRIPTION 

Termcap is a data base describing terminals, used, by 

vi(1) and curses (3). Terminals are described in termcap by 
giving a set of capabilities which they have, and by 
describing how operations are performed. Padding 
requirements and initialization sequences are included in 
termcap . 

Entries in termcap consist of a number cf separated 
fields. The first entry for each terminal gives the names 
which are known for the terminal, separated by '1 * 
characters. The first name is always 2 characters long and 
is used by older version 6 systems which store the terminal 
type in a 16 bit word in a systemwide data base. The second 
name given is the most common abbreviation for the terminal, 
and the last name given should be a long name fully 
identifying the terminal. The second name should contain no 
blanks; the last name may well contain blanks for 
readability. 

CAPABILITIES 

ng may be specified 

padding may be based on no. lines affected 
Description 

End alternate character set 
Add new blank line 
Terminal has automatic margins 
Start alternate character set 
Backspace if not '*'H 
Terminal can backspace with 
Back tab 

Backspace wraps from column 0 to last oolumn 
Command char in prototype if terminal settable 
Clear to end of display 
Clear to end of line 

Like cm but horiz motion only, line stays same 
Clear screen 
Cursor motion 

Number of columns in a line 
Carriage return, (default '“M) 

Change scrolling region (vtl00), like cm 
Like ch but vertical only. 

Display may be retained above 
Number of millisec of bs delay needed 
Display may be retained below 


(P) indicates paddi 
(P*) indicates that 


Name 

Type 

Pad? 

ae 

str 

(P) 

al 

str 

(P*) 

am 

bool 


as 

str 

(P) 

be 

str 


bs 

bool 


bt 

str 

(P) 

bw 

bool 


CC 

str 


cd 

str 

(P*) 

ce 

str 

(P) 

ch 

str 

(P) 

cl 

str 

(P*) 

cm 

str 

(P) 

CO 

num 


cr 

str 

(P*) 

cs 

str 

(P) 

cv 

str 

(P) 

da 

bool 


dB 

num 


db 

bool 
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dC 

dc 

dF 

dl 

dm 

dN 

do 

dT 

ed 

ei 

eo 

ff 

he 

hd 

ho 

hu 

hz 

ic 

if 

Im 

In 

ip 

is 

k0-k9 

kb 

kd 

ke 

kh 

kl 

kn 

ko 

kr 

ks 

ku 

10-19 

li 

11 

ma 

mi 

ml 

mu 

nc 

nd 

nl 

ns 

os 

pc 

Pt 

se 

sf 

sg 

so 


num 

str (P*) 
num 

str (P*) 

str 

num 

str 

num 

str 

str 

str 

str (P*) 

bool 

str 

str 

str 

str 

str (P) 
str 
bool 
bool 

str (P*) 

str 

str 

str 

str 

str 

str 

str 

num 

str 

str 

str 

str 

str 

num 

str 

str 

bool 

str 

str 

bool 

str 

str (P*) 

bool 

bool 

str 

bool 

str 

str (P) 

num 

str 


Number of millisec of cr delay needed 
Delete character 

Number of millisec of ff delay needed 

Delete line 

Delete mode (enter) 

Number of millisec of nl delay needed 
Down one line 

Number of millisec of tab delay needed 
End delete mode 

End insert mode; give ;ei=: if ic 
Can erase overstrikes with a blank 
Hardcopy terminal page eject (default '‘L) 
Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 

Home cursor (if no cm) 

Half-line up (reverse 1/2 linefeed) 

Hazeltine; can't print ~'s 

Insert character 

Name of file containing is 

Insert mode (enter); give :im=s: if ic 

Insert mode distinguishes nulls on display 

Insert pad after character inserted 

Terminal initialization string 

Sent by other function keys 0-9 

Sent by backspace key 

Sent by terminal down arrow key 

Out of keypad transmit mode 

Sent by home key 

Sent by terminal left arrow key 

Number of other keys 

Termcap entries for other non-function keys 

Sent by terminal right arrow key 

Put terminal in keypad transmit mode 

Sent by terminal up arrow key 

Labels on other function keys 

Number of lines on screen or page 

Last line, first column (if no cm) 

Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Memory unlock (turn off memory lock). 

No working carriage return (DM2500,H2000) 
^Non-destructive space (cursor right) 

Newline character (default \n) 

Terminal is a CRT but doesn't scroll. 

Terminal overstrikes 

Pad character (rather than null) 

Has hardware tabs (may need to be set with is) 
End stand out mode 
Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 
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sr 

str 

ta 

str 

tc 

str 

te 

str 

ti 

str 

uc 

str 

ue 

str 

ug 

num 

ul 

bool 

up 

str 

us 

str 

vb 

str 

ve 

str 

vs 

str 

xb 

bool 

xn 

bool 

xr 

bool 

xs 

bool 

xt 

bool 


(P) 
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Scroll reverse (backwards) 

Tab (other than or with padding) 

Entry of similar tertkinal - must be l-ist 
String to end programs that use cm 
String to begin programs that use cm 
Underscore one char ^nd move past it 
End underscore mode 

Number of blank char^ left by us or u€i 
Terminal underlines ^ven though cannot, overstirike 
Upline (cursor up) 

Start underscore mode 
Visible bell (may noip move cursor) 

Sequence to end open/visual mode 
Sequence to start op<5n/visual mode 
Beehive (fl=escape, :^2=ctrl C) 

A newline is ignored after a wrap (Coricept) 

Return acts like ce \r \n (Delta Data) 

Standout not erased liy writing over it (HP 2^4?) 
Tabs are destructive^ magic so char (lleleray 1061) 


A Sample Entry 


The following entry, which describes the 
among the more complex entries in the ^ 
this writing. (This particular concept 
and is used as an example only.) 

cl I cl00 I conceptl00; is=\EU\Ef\E7\E5\E8\E1\ENH'| 
;al=3*\E''R:am:bs:cd=16*\E''C;ce=16\E'‘S:cl= 
:dc=16\E"A:dl=3*\E"B:ei=\E\200:eo;im=\E^P^ 
;se=\Ed\Ee: so=\ED\EE; ta=8\t:ul:up=\E;;vb= 


Concept-100, is 
rmcap file as of 


entry is outdated 


Entries may continue onto multiple line^ 
the last character of a line, and that 
included for readability (here between 
line and the first field on the next). 
termcap are of three types; Boolean capc| 
indicate that the terminal has some partj 
numeric capabilities giving the size of 
size of particular delays, and string cal 
give a sequence which can be used to pei| 
terminal operations. 

Types of Capabilities 


by giving a \ as 
empty fields may b 
he last field' on 
Capabilities in 
•bilities which 
icular feature, 
the terminal or 
•pabilities, which] 
form particular 


All capabilities have two letter codes, 
fact that the Concept has automatic mar<^ 
automatic return and linefeed when the e] 
reached) is indicated by the capability 
description of the Concept includes eun. 
capabilities are followed by the charact! 
value. Thus co which indicates the numti 


EK\E\200\Eo&\ 200 
*"L;cra=\Ea%+ %+ 
in;ip=16*;li#24: 
Ek\EK;xn; 


\ 

co#88;\ 
mi:nd=\S=;\ 


tlie 


For instance, th| 
ins (i.e. an 
nd of a line is 
am. Hence the 
Numeric 

er '#' and then the 
er of columns the 
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terminal has gives the value '80' for the Concept. 

Finally, string valued capabilities, such as ce (clear to 
end of line sequence) are given by the two character code, 
an and then a string ending at the next following 

A delay in milliseconds may appear after the '=' in such a 
capability, and padding characters are supplied by the 
editor after the remainder of the string is sent to provide 
this delay. The delay can be either a integer, e.g. '20', 
or an integer followed by an '*', i.e. '3*'. A '*' 
indicates that the padding required is proportional to the 
number of lines affected by the operation, and the amount 
given is the per-affected-unit padding required. When a '*' 
is specified, it is sometimes useful to give a delay of the 
form '3.5* specify a delay per unit to tenths of 
milliseconds. 

A number of escape sequences are provided in the string 
valued capabilities for easy encoding of characters there. 

A \E maps to an ESCAPE character, ''x maps to a control-x for 
any appropriate x, and the sequences \n \r \t \b \f give a 
newline, return, tab, backspace and formfeed. Finally, 
characters may be given as three octal digits after a \, and 
the characters ^ and \ may be given as and \\. If it is 
necessary to place a : in a capability it must be escaped in 
octal as \072. If it is necessary to place a null character 
in a string capability it must be encoded as \200. The 
routines which deal with termcap use C strings, and strip 
the high bits of the output very late so that a \200 comes 
out as a \000 would. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. 

The most effective way to prepare a terminal description is 
by imitating the description of a similar terminal in 
termcap and to build up a descrijJtion gradually, using 
partial descriptions with ex to check that they are correct. 
Be aware that a very unusual terminal may expose 
deficiencies in the ability of the termcap file to describe 
it or bugs in To easily test a new terminal description 
you can set the environment variable TERMCAP to a pathname 
of a file containing the description you are working on and 
the editor will look there rather than in /etc/termcap. 
TERMCAP can also be set to the termcap entry itself to avoid 
reading the file when starting up the editor. (This only 
works on version 7 systems.) 

Basic capabilities 

The number of columns on each line for the terminal is given 
by the co numeric capability. If the terminal is a CRT, 
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Page 


then the number of lines on the screen is 
capability. If the terminal wraps aroun<^ 
of the next line when it reaches the rig 
should have the cim capability. If the t 
its screen, then this is given by the cl 
If the terminal can bacTcspace, then it s 
capability, unless a backspace is accorap:|. 
character other than *11 (ugh) in which 
this character as the be string capabili 
overstrikes (rather than clearing a posii 
character is struck over) then it should 
capability. 


ca 

iil 


h very important point here is that the ^ocal cursor raotio 
encoded in termcap are undefined at the left and top edgei^ 
of a CRT terminal. The editor will never attempt to 
backspace around the left edge, nor will 
locally off the top. The editor assumes 
the bottom of the screen will cause the Screen to scroll 
and the am capability tells whether the <iursor sticks at t| 
right edge of the screen. If the terminal has switch 
selectable automatic margins, the termcap file usually 
assumes that this is on, i.e. am. 


given by the li 
to the beginning 
lilt margin, then if 
erminal can clear 
string capabiliti[^. 
Ijiould have the bs 
ished by a 
se you should gi^|e 
y. If it 
ion when a 
have the os 


it attempt to go 
that feeding off 


UP 


These capabilities suffice to describe ha 
tty terminals. Thus the model 33 teletyii 


t3133 Itty33:co#72:os 
v/hile the Lear Siegler A,DM-3 is describe 4 
cl 1 adm3 1 3 1 Isi adm3 ; amibs; cl=''Z; li#2 


Cursor addressing 


Cursor addressing in the terminal is desc 
string capability, with printf (3s) like 
These substitute to encodings of the cur 
position, while other characters are pas 
unchanged. If the cm string is thought 
function, then its arguments are the lin4 
column to which motion is desired, and tli 
the following meanings: 


rdcopy and glass- 
e is described as 


as 

:co#80 


ns 


up 


i'' / 

he 


ribed by a cm 

3 scapes %x in it. 
ent line or colu4 
ed through 
cif as being a 
and then the 
e % encodings havl 


n 


e 


%d as in printf , 0 origin 
%2 like %2d 

%3 like %3d 

%. like %c 

%+x adds X to value, then %. 

%>xy if value > x adds y, no output. 

%r reverses order of line and column, no output 
%i increments line/column (for 1 origin) 
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%% gives a single % 

%n exclusive or row and column with 0140 (DM2500) 

%B BCD (16*(x/10)) + (x%10), no output. 

%D Reverse coding (x-2*(x%16)), no output. (Delta Data). 

Consider the HP2645, which, to get to row 3 and column 12, 
needs to be sent \E&al2c03Y padded for 6 milliseconds. Note 
that the order of the rows and colurans is inverted here, and 
that the row and column are printed as two digits. Thus its 
cm capability is crn=6\E&%r%2c%2Y. The Microterm ACT—IV 
needs the current row and column sent preceded by a ^'T, with 
the row and column simply encoded in binary, cm=^T%.%.. 
Terminals which use %. need to be able to backspace the 
cursor (bs or be), and to move the cursor up one line on the 
screen (up introduced below). This is necessary because it 
is not always safe to transmit \t, \n and \r, as the 
system may change or discard them. 

A final example is the LSI ADM-3a, which uses row and column 
offset by a blank character, thus cm=\E=%+ %+ . 

Cursor motions 

If the terminal can move the cursor one position to the 
right, leaving the character at the current position 
unchanged, then this sequence should be given as nd (non¬ 
destructive space). If it can move the cursor up a line on 
the screen in the same column, this should be given as up. 

If the terminal has no cursor addressing capability, but can 
home the cursor (to very upper left corner of screen) then 
this can be given as ho; similarly a fast way of getting to 
the lower left hand corner can be given as 11; this may 
involve going up with up from the home position, but the 
editor will never do this itself (unless 11 does) because it 
makes no assumption about the effect of moving up from the 
home position. 

Area clears 

If the terminal can clear from the current position to the 
end of the line, leaving the cursor where it is, this should 
be given as ce. If the terminal can clear from the current 
position to the end of the display, then this should be 
given as cd. The editor only uses cd from the first column 
of a line. 

Insert/delete line 

If the terminal can open a new blank line before the line 
where the cursor is, this should be given as al; this is 
done only from the first position of a line. The cursor 
must then appear on the newly blank line. If the terminal 
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can delete the line which the cursor is on, then this should 

the first position on 


al 
ve 

y 

These l4t 

may 

that scrolling balch 


be given as dl; this is done only from 

the line to be deleted. If the terminal can scroll the 
screen backwards, then this can be giv^n as sb, but just 
suffices. If the terminal can retain display memory abo 
then the da capability should be given; if display memoi 
can be retained below then db should b^ given, 
the editor understand that deleting a line on the scree4 
bring non-blank lines up from below or 
with sb may bring down non-blank lines. 

Insert/delete character 

There are two basic kinds of intelliger.t terminals with 
respect to insert/delete character which can be described 
using termcap . The most common insert/delete character 
operations affect only the characters cn the current line 
and shift characters off the end of thej line rigidly 
terminals, such as the Concef>t 100 and the Perkin Elmer 
make a distinction between typed and untyped blanks on the 
screen, shifting upon an insert or delate only to an untyped 
blank on the screen which is either eliminated, or expanded 
to two untyped blanks. You can find oult which kind of 
terminal you have by clearing the screen and then typing 
text separated by cursor motions. Type abc def using 
local cursor motions (not spaces) between the abc and the 
def. Then position the cursor before the abc and put the 
terminal in insert mode. If typing characters causes the 
rest of the line to shift rigidly and characters to fall 
the end, then your terminal does not distinguish between 
blanks and untyped positions. If the abc shifts over to 

def which then move together around the _ _ 

line and onto the next as you insert, you have the second 
type of terminal, and should give the capability in, whiph 
stands for insert null. If your terminal does someth-ing 
different and unusual then you may have to modify the editor 
to get it to use the insert mode your terminal defines. jWe 


Other 

Owl, 


have seen no terminals which have an in 
falling into one of these two classes. 


sert mode not not 


whi 


The editor can handle both terminals 
mode, and terminals which send a simple 
blank position on the current line. Gi 
to get into insert mode, or give it an 
terminal uses a sequence to insert a bl 
as ei the sequence to leave insert mode 
empty value also if you gave im so). N 
sequence needed to be sent just before 
to be inserted. Most terminals with a 
not give ic, terminals which send a seq 
screen position should give it here. ( 
preferable to the sequence to open a po 
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pence to open a 
Insert mode is 
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if your terminal has both.) If post insert padding is 
needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence which may need to be 
sent after an insert of a single character may also be given 
in ip. 

It is occasionally necessary to move around while in insert 
mode to delete characters on the same line (e.g. if there is 
a tab after the insertion position). If your terminal 
allows motion while in insert mode you can give the 
capability mi to speed up inserting in this case. Omitting 
mi will affect only speed. Some terminals (notably 
Datamedia's) must not have mi because of the way their 
insert mode works. 

Finally, you can specify delete mode by giving dm and ed to 
enter and exit delete mode, and dc to delete a single 
character while in delete mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout 
mode these can be given as so and se respectively. If there 
are several flavors of standout mode (such as inverse video, 
blinking, or underlining - half bright is not usually an 
acceptable standout mode unless the terminal is in inverse 
video mode constantly) the preferred mode is inverse video 
by itself. If the code to change into or out of standout 
mode leaves one or even two blank spaces on the screen, as 
the TVI 912 and Teleray 1061 do, this is acceptable, and 
although it may confuse some programs slightly, it can't be 
helped. 

Codes to begin underlining and end underlining can be given 
as us and ue respectively. If the terminal has a code to 
underline the current character and move the cursor one 
space to the right, such as the Microterm Mime, this can be 
given as uc. (if the underline code does not move the 
cursor to the right, give the code followed by a 
nondestructive space.) 

If the terminal has a way of flashing the screen to indicate 
an error quietly (a bell replacement) then this can be given 
as vb; it must not move the cursor. If the terminal should 
be placed in a different mode during open and visual modes 
of ex , this can be given as vs and ve, sent at the start and 
end of these modes respectively. These can be used to 
change, e.g., from a underline to a block cursor and back. 

If the terminal needs to be in a special mode when running a 
program that addresses the cursor, the codes to enter and 
exit this mode can be given as ti and te. This arises, for 
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example/ from terminals like the Concept 
page of memory. If the terminal has on 
cursor addressing and not screen relati^j' 
a one screen-sized window must be fixed 
for cursor addressing to work properly. 


with more than One 
y memory relativei 
e cursor addressing, 
into the terminal 


If your terminal correctly generates 
(with no special codes needed) even thoiji 
overstrike, then you should give the ca 
overstrikes are erasable with a blank, 
indicated by giving eo. 

Keypad 


underlined characterfs 
gh it does not 
pability ul. If 
hen this should tie 


If the terminal has a keypad that transmits codes when the 
keys are pressed, this information can be given. Note that 
it is not possible to handle terminals where the keypad only 
works in local (this applies, for example, to the unshifted 
HP 2621 keys). If the keypad can be set to transmit or njot 
transmit, give these codes as ks and ke. Otherwise the 
keypad is assumed to always transmit. The codes sent by the 
left arrow, right arrow, up arrow, down arrow, and home keys 
can be given as kl, kr, ku, kd, and kh respectively. If 
there are function keys such as f0, fl, ..., f9, the codes 
they send can be given as k0, kl, k9. If these keys 

have labels other than the default f0 through f9, the labels 
can be given as 10, 11, ..., 19. If there are other keys 
that transmit the same code as the terminal expects for the 
corresponding function, such as clear screen, the termcap 2 
letter codes can be given in the ko capability, for example, 
;ko=cl,11,sf,sb:, which says that the terminal has clear, 
home down, scroll down, and scroll up keys that transmit [the 
same thing as the cl, 11, sf, and sb entries 


The ma entry is also used to indicate ar 
terminals which have single character ar 
obsolete but still in use in version 2 o 
run on some minicomputers due to memory 
field is redundant with kl, kr, ku, kd, 
of groups of two characters. In each gr 
character is what an arrow key sends, th 
is the corresponding vi command. These 
kl, j for kd, k for ku, 1 for kr, and H 
example, the mime would be ;ma='‘Kj'^Zk'^Xlj 
keys left (“'h), down (^K), up (^Z), and 
is no home key on the mime.) 

Miscellaneous 

If the terminal requires other than a nu 
as a pad, then this can be given as pc. 
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If tabs on the terminal require padding, or if the terminal 
uses a character other than '^I to tab, then this can be 
given as ta. 

Hazeltine terminals, which don't allow characters to be 
printed should indicate hz. Datamedia terminals, which echo 
carriage-return linefeed for carriage return and then ignore 
a following linefeed should indicate nc. Early Concept 
terminals, which ignore a linefeed immediately after an am 
wrap, should indicate xn. If an erase-eol is required to 
get rid of standout (instead of merely writing on top of 
it), xs should be given. Teleray terminals, where tabs turn 
all characters moved over to blanks, should indicate xt. 
Other specific terminal problems may be corrected by adding 
more capabilities of the form xx. 

Other capabilities include is, an initialization string for 
the terminal, and if, the name of a file containing long 
initialization strings. These strings are expected to 
properly clear and then set the tabs on the terminal, if the 
terminal has settable tabs. If both are given, is will be 
printed before if. This is useful where if is 
/usr/ lib / tabset / std but is clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined 
as being just like the other with certain exceptions. The 
string capability tc can be given with the name of the 
similar terminal. This capability must be last and the 
combined length of the two entries must not exceed 1024. 
Since termlib routines search the entry from left to right, 
and since the tc capability is replaced by the corresponding 
entry, the capabilities given at the left override the ones 
in the similar terminal. A capability can be canceled with 
xx@ where xx is the capability. For example, the entry 

hnl2621nl;ks@;ke@:tc=2621: 

defines a 2621nl that does not have the ks or ke 
capabilities, and hence does not turn on the function key 
labels when in visual mode. This is useful for different 
modes for a terminal, or for different user preferences. 


FILES 

/etc/termcap file containing terminal descriptions 
SEE ALSO 

ex(l), curses(3), termcap(3), tset(l), vi(l), ul(l), more(l) 

AUTHOR 

William Joy 
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Mark Horton added underlining and keypad support 

BUGS 

Ex allows only 256 characters for string capabilities, an 
the routines in termcap (3) do not check for overflow of t 
buffer. The total length of a single entry (excluding on 
escaped newlines) may not exceed 1024. 

The ma, vs, and ve entries are specific to the program 

Not all programs support all entries. Tliere are entries 
that are not supported by any program. 
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NAME 

ttys - terminal initialization data 


DESCRIPTION 

The ttys file is read by the init program and specifies 
which terminal special files are to have a process created 
for them which will allow people to log in. It contains one 
line per special file. 


The first character of a line is either '0' or 'l'; the 
former causes the line to be ignored, the latter causes it 
to be effective. The second character is used as an 
argument to getty (8), which performs such tasks as baud-rate 
recognition, reading the login name, and calling login. For 
normal lines, the character is '0'; other characters can be 
used, for example, with hard-wired terminals where speed 
recognition is unnecessary or which have special 
characteristics. ( Getty will have to be fixed in such 
cases.) The remainder of the line is the terminal's entry in 
the device directory, /dev. 

FILES 

/etc/ttys 


SEE ALSO 

init(8), getty(8), login(l) 
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NAME 

types - primitive system data types 
SYNOPSIS 

#include <sys/types.h> 


DESCRIPTION 

The data types defined in the include filjs 
system code; some data of these types are 
code; 


are used in UNIX 
accessible to user 


/* 


RA' 


7 


(C) COPYRIGHT, TEXAS INSTRUMENTS INCORPO 
RIGHTS RESERVED. PROPERTY OF TEXAS INSTRi 
RESTRICTED RIGHTS - USE, DUPLICATION, OR 
TO RESTRICTIONS SET FORTH IN TI'S PROGRAM 
ASSOCIATED DOCUMENTATION. 


#ifdef 3CCSI0 

static char id_types[] = "@(#)types.h 1.2 (T 
#endif 

fifndef 3CCSID 


typedef long daddr_t; 

typedef char * caddr_t; 

typedef long mem_t; 

typedef unsigned short ino_t; 
typedef long time_t; 

typedef long label_tCl3]; !'* 

typedef short dev_t; 

typedef long off_t; 


TED, 1983. ALL 
UMENTS INCORPORATJbD. 
DISCLOSURE IS SUBJECT 
LICENSE AGREEMENT AND 


exas Instruments) 


83/06/27" 


regs d2-d7, a2-a7, pc * 


/* selectors and constructor for device code */ 
#define major(x) (int)(((unsigned)x>>8)) 

#define minor(x) (int)(x&0377) 

tdefine makedev(x,y) (dev t)((x)<<81(y)) 


#endif 


The form daddr t is used for dish addresse 
node on disk, see filsys (5). Times are e 
since 00;00;00 GMT, January 1, 1970. The 
parts of a device code specify kind and u 
device and are installation-dependent. O 


Th 


in bytes from the beginning of a file. _ 

variables are used to save the processor state while another 
process is running. 

SEE ALSO 

filsys(5), time(2), lseek(2), adb(l) 


/ 


s except in an i4 
liicoded in seconds 
major and minor 
ijiit number of a 
ffsets are raeasur 
e label t 


4d 
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NAME 

utmp, wtrap - login records 
SYNOPSIS 

#include <utmp.h> 

DESCRIPTION 

The utmp file allows one to discover information about who 
is currently using UNIX. The file is a sequence of entries 
with the following structure declared in the include file; 

struct utmp { 

char ut_lineC83; 
char ut_nameC8]; 
long ut time; 

}; 

This structure gives the name of the special file associated 
v/ith the user's terminal, the user's login name, and the 
time of the login in the form of time (2). 

The wtmp file records all logins and logouts. Its format is 
exactly like utiap excexst that a null user name indicates a 
logout on the associated terminal. Furthermore, the 
terminal name indicates that the system was rebooted at 
the indicated time; the adjacent pair of entries with 
terminal names 'I' and '1' indicate the system-maintained 
time just before and just after a date command has changed 
the system's idea of the time. 

Wtmp is maintained by login (l) and init (8). Neither of 
these programs creates the file, so if it is removed 
record-keeping is turned off. It is summarized by ac(1). 


/* tty name */ 
/* user id */ 
/* time on */ 


FILES 

/etc/utmp 
/us r/adm/wtmp 

SEE ALSO 

login(l), init(8), who(l), ac(l) 
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